Python venv 虚拟环境入门：三分钟搞定依赖隔离

刚开始写 Python 的朋友常会遇到这样的问题：在同一台机器上，A 项目需要 requests 1.x，B 项目却要 requests 2.x，卸了装、装了卸，最后环境一团糟。解决办法很简单——给每个项目一个独立的虚拟环境（venv）。

一、venv 是什么

venv 是 Python 3.3 以后官方自带的虚拟环境模块，不需要安装任何第三方工具。它会在项目目录里创建一个独立的 Python 运行环境，拥有自己的解释器和 site-packages，装什么库都只影响这个项目，互不干扰。

二、三步创建并使用

第一步，在项目根目录创建环境：

python -m venv .venv

第二步，激活环境。Windows PowerShell：

.venv\Scripts\Activate.ps1

macOS / Linux：

source .venv/bin/activate

激活成功后命令行前面会出现 (.venv) 前缀，此时 pip install 安装的一切都只进这个环境。

第三步，导出依赖清单，方便别人复现：

pip freeze > requirements.txt

同事拿到代码后，只需要创建虚拟环境、激活、再 pip install -r requirements.txt，就能得到一模一样的环境。

三、两个常见小坑

1. VS Code 打开项目后，记得在右下角选择解释器时选中 .venv 里的 python，否则终端里跑的还是全局环境。

2. .venv 目录不要提交到 Git，在 .gitignore 里加一行 .venv/ 即可——环境随时可以重建，requirements.txt 才是需要版本管理的部分。

小结

venv 的学习成本几乎为零：一条命令创建、一条命令激活、一条命令导出。养成“一个项目一个环境”的习惯，依赖冲突这类问题基本就和你说再见了。如果你的团队还在共用一个全局 Python，今天就把新项目迁到 venv 上试试。