Python 虚拟环境入门：用 venv 为每个项目准备独立的依赖空间

写 Python 一段时间后，很多人会遇到这样的问题：项目 A 需要 requests 2.x，项目 B 却依赖旧版本，全都装在系统环境里就会“打架”。虚拟环境就是解决方案：给每个项目一个单独的、互不干扰的包目录。Python 3.3 之后自带的 venv 模块就能完成这件事，不需要额外安装任何工具。

一、创建并激活虚拟环境

mkdir myproject && cd myproject
python3 -m venv .venv
source .venv/bin/activate      # Windows: .venvScriptsactivate

激活后，终端提示符前面会出现 (.venv)。此时执行 which python 会指向项目目录下的 .venv，而不是系统自带的 Python。

二、安装依赖并记录版本

pip install requests
pip freeze > requirements.txt

pip freeze 会把当前环境里已安装的包及版本写入 requirements.txt。把这个文件提交到代码仓库，同事或服务器上就能复现同样的环境。

三、在另一台机器上复现环境

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

三条命令就能拿到和你一致的依赖。需要注意，.venv 目录本身不要提交到 Git，建议把它加入 .gitignore。

四、退出与清理

deactivate
rm -rf .venv

deactivate 退出当前虚拟环境；不再需要时直接删除 .venv 目录即可，不会影响系统环境。

五、常见小坑

第一，忘记激活就直接 pip install，包会装到系统环境里；第二，把项目文件夹改名或移动后，虚拟环境里的路径可能失效，重新创建即可；第三，IDE（如华为云码道）里要把解释器选择为 .venv 下的 python，否则代码提示和运行环境会与终端不一致。

小结

“一个项目一个虚拟环境 + 一个 requirements.txt”是 Python 项目最基础也最值得养成的习惯。熟练后可以再了解 pip-tools、Poetry 等更完整的依赖管理方案。欢迎在评论区交流你的使用经验。