Python本地开发环境的核心是隔离、可复现和轻量，通过venv创建项目级虚拟环境，用pyproject.toml或requirements.txt声明依赖，配合black、ruff、pytest等工具实现高效开发。
Python 本地开发环境的核心是隔离、可复现和轻量——用 venv + pip 搭建干净的项目级环境，配合 requirements.txt 或 pyproject.toml 管理依赖，避免全局污染和版本冲突。
用 venv 创建项目专属环境
Python 3.3+ 自带 venv，无需额外安装。在项目根目录执行：
- python -m venv .venv —— 创建名为 .venv 的隔离环境（推荐用隐藏文件夹，避免误提交）
- source .venv/bin/activate（macOS/Linux）或 .\.venv\Scripts\activate（Windows）—— 激活环境
- 激活后命令行前缀会出现 (.venv)，此时 pip install 安装的包仅对该项目生效
明确声明依赖，拒绝“pip freeze > requirements.txt”式操作
直接导出当前环境所有包（含间接依赖）会导致 requirements.txt 过于宽泛、难以维护。更合理的方式是：
- 用 pip install -e . 安装本项目（需有 setup.py 或 pyproject.toml），再用 pip list --format=freeze > requirements.txt 导出顶层依赖
- 或直接使用现代方式：在 pyproject.toml 中声明 [project.dependencies]，工具如 pip-tools 可生成锁定版 requirements.txt
- 始终把 requirements.txt 提交到 Git，但排除 .venv/、__pycache__/ 等目录
编辑器与环境联动要自动识别
VS Code 和 PyCharm 都能自动发现 .venv 并启用对应 Python 解释器，但需注意：
立即学习“Python免费学习笔记（深入）”；
- VS Code：打开文件夹后，按 Ctrl+Shift+P → “Python: Select Interpreter”，选中 .venv/bin/python（或 Scripts\python.exe）
- PyCharm：新建项目时选择 “New environment using Virtualenv”，路径设为项目内 .venv；已有项目可在 Settings → Project → Python Interpreter 中点击齿轮 → “Add…” → 选择现有环境
- 确保编辑器终端也继承了激活的环境（VS Code 默认开启 “Python › Terminal: Execute In File Dir”，可避免手动 activate）
小而必要的工具链补充
基础环境之上，加几个高频实用工具即可覆盖大多数日常开发场景：
- black（代码格式化）：pip install black，保存时自动格式化，团队无需争论缩进空格
- ruff（快如闪电的 linting）：替代 flake8 + isort + pydocstyle，支持一键修复，pip install ruff
- pytest（测试）：比 unittest 更简洁，pip install pytest，写 test_*.py 文件即可运行
- 全部装入 .venv 内，不污染系统，且可随项目一起迁移
