Python 虚拟环境 venv 最佳实践

Python 项目最常见的问题之一是“在我电脑上能跑”。虚拟环境的目标是让依赖可控、可复现、互不污染。

1. 创建与激活

python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -V
pip -V

2. 固化依赖

pip install -r requirements.txt
pip freeze > requirements.txt

建议：

• 生产依赖与开发依赖分开
• 对关键库做版本上限/下限约束，避免隐式升级

3. 常见坑

• 系统 Python 与 venv 混用导致包装错位置
• VS Code 解释器未切到 .venv
• requirements 里带了平台相关 wheel（跨平台安装失败）