Python venv 虚拟环境入门：隔离依赖，从此告别版本冲突

为什么需要虚拟环境

刚学 Python 时，很多人直接在系统 Python 里 pip install。项目 A 要 requests 2.28，项目 B 要 requests 2.31，升级一个就可能破坏另一个；换台电脑重装依赖，又要翻聊天记录找版本。venv 是 Python 3.3 起内置的解决方案：为每个项目创建一个独立的解释器副本和 site-packages，依赖互不干扰，删掉文件夹就等于卸载整个环境，干净又可控。

创建与激活

在项目根目录执行：python -m venv .venv。Windows 激活：.venv\Scripts\activate；macOS 和 Linux 激活：source .venv/bin/activate。成功后命令行前面会出现 (.venv)，这就是当前环境已生效的标志。退出时执行 deactivate。

安装依赖与冻结版本

激活后执行 pip install requests，就只装进当前环境，不污染全局。养成两个习惯：第一，项目一开始就建 requirements.txt；第二，依赖定型后执行 pip freeze > requirements.txt，把版本锁死。别人拿到项目，只需新建 venv 再执行 pip install -r requirements.txt，就能复现同一套环境。

常见坑

第一，.venv 不要提交到 Git，在 .gitignore 里加一行 .venv/。第二，激活后先确认 python 和 pip 的路径指向 .venv，否则会装错位置。第三，不要在 venv 里升级 pip 到一半断网，必要时用 python -m pip install --upgrade pip 重试。第四，IDE 里要把解释器指向 .venv/bin/python，否则代码提示和运行用的还是系统 Python。

一个小练习

新建 demo 文件夹，创建 venv，安装 requests，用 python -c “import requests; print(requests.version)” 验证版本，再用 pip freeze 导出清单，最后 deactivate 并删除 .venv，重新按清单恢复。走通一次，以后每个 Python 项目都按这个流程来，环境问题会少一大半。