永远用 python -m pip
bashpython -m pip install requests
而不是直接 pip install。原因是 pip 这个命令在 Windows 上可能指向另一个解释器装的版本——尤其当你同时装了多个 Python，或者用 --user 装过东西之后。python -m pip 里的 python 就是当前解释器，装的包一定落在它自己的 site-packages 里。
判断当前解释器是谁：
bashpython -c "import sys; print(sys.executable)"
python --version
python -m pip --version
最后一条同时给出 pip 自身路径和它绑定的解释器版本，是排查「装到哪儿去了」最快的办法。
虚拟环境
每个项目一个虚拟环境，不要往基础解释器里堆包：
bashpython -m venv .venv
激活方式分平台：
bash# Windows (PowerShell / CMD)
.venv\Scripts\activate
# macOS / Linux
source .venv/bin/activate
激活后提示符会变（PowerShell 上通常是 (.venv) 前缀），此时 python 和 pip 都指向 .venv 里的版本。
三个易错点：
- 别把
.venv 提交进 Git。 加进 .gitignore。 - 别用
virtualenv 替代 venv。 venv 是标准库自带的，无需额外安装；virtualenv 是第三方包，功能更强但多一个依赖。 - 每个项目独立创建，不要共用一个全局 venv。 共用会让依赖冲突在很晚才暴露，且无法复现。
迁移环境或交付给别人时，导出依赖清单：
bashpython -m pip freeze > requirements.txt
对方用 python -m pip install -r requirements.txt 还原。
py 启动器（Windows）
Windows 上的 py 启动器可以挑具体版本，且不依赖 PATH 配置：
bashpy -3.12 script.py
py -3.12 -m venv .venv
py -0p # 列出本机所有可用版本
在需要指定 Python 版本的脚本里，用 py 比用 python 可靠——后者可能命中 Microsoft Store 的别名，或者压根不存在。
项目的目录与配置
现代项目用 pyproject.toml 声明元数据与依赖，而不是 setup.py：
toml[project]
name = "myproject"
version = "0.1.0"
requires-python = ">=3.10"
dependencies = [
"requests>=2.31",
]
[project.scripts]
mytool = "myproject.cli:main"
开发模式安装（改代码即时生效，代替反复手动重装）：
bashpython -m pip install -e .
目录上把包放成 src/ 布局比平铺更清晰：项目根下只留配置，代码全在 src/包名/ 里。平铺布局里，测试目录容易被误当成包导入。
缩进就是语法
Python 用缩进划分代码块，没有花括号。所以混用 Tab 和空格会直接报 IndentationError，同一文件内必须统一用空格（官方规范是 4 个）。
多行字符串用三引号，四个单引号或三个双引号都可以，缩进会原样保留，常用于写 SQL 或 HTML 模板：
pythonquery = """
SELECT id, name
FROM users
WHERE created_at > %s
"""
版本差异要说清
match 语句需要 3.10 以上，X | Y 形式的类型标注需要 3.10 以上，:= 海象运算符需要 3.8。写 pyproject.toml 里的 requires-python 之前先确认下限，别写出装不上包的声明。