Python 虚拟环境入门：用 venv 隔离项目依赖的完整操作指南

在同一个电脑上开发多个 Python 项目时，经常会遇到这样的冲突：项目甲需要某个库的旧版本，项目乙却必须用新版本；系统自带的 Python 还被操作系统组件依赖，随意升级或卸载包可能把系统工具也弄坏。虚拟环境就是为解决这类问题而生的：它为每个项目创建一个独立的解释器副本和包目录，项目之间互不干扰，环境可以随时按清单重建，删掉也不会影响系统 Python。

一、创建虚拟环境

Python 3.3 以上自带 venv 模块，不需要额外安装工具。在项目根目录打开终端，执行 python -m venv .venv 即可，其中 .venv 是环境目录名，也可以换成其他名字。命令完成后，目录里会出现解释器、pip 和激活脚本。建议每个项目单独建一个环境，不要多个项目共用同一个环境，否则隔离就失去了意义。如果电脑上装了多个 Python 版本，创建时要用目标版本的解释器执行这条命令，创建后环境里的 Python 版本就固定为该版本。

二、激活与退出

使用环境前必须先激活。Windows 的命令提示符执行 .venv\Scripts\activate.bat，PowerShell 执行 .venv\Scripts\Activate.ps1，若 PowerShell 提示禁止运行脚本，可先在当前窗口放宽执行策略再激活。Linux 和 macOS 执行 source .venv/bin/activate。激活成功后，终端提示符前会出现环境名，此时 python 和 pip 都指向环境内部。退出时在任意平台执行 deactivate 即可回到系统环境，退出不会删除已安装的包。

三、安装依赖与清单迁移

激活后用 pip install 加包名安装依赖，包只会进入当前环境，用 pip list 可以查看已装版本。当项目要交付或换电脑时，执行 pip freeze 并把输出保存到 requirements.txt，就得到依赖清单；到新环境里先创建并激活虚拟环境，再执行 pip install -r requirements.txt，就能按清单恢复同样的依赖。清单文件应该随代码一起保存，它是重建环境的说明书。

四、删除与重建

不再需要的环境，退出后直接删除整个 .venv 目录即可，不会留下系统配置。环境损坏时也不必逐个抢修，删掉目录重新创建、再按清单安装，往往比逐个排查版本冲突更快。

五、常见坑

第一，忘记激活就安装依赖，包被装进系统 Python，运行时却提示找不到模块，养成先看提示符前环境名的习惯。第二，把 venv 目录提交到 Git，体积大且包含本机绝对路径，换一台机器根本不能用，应把环境目录写进忽略文件，只提交源码和 requirements.txt。第三，在编辑器里选错解释器，代码检查用的是另一个环境，也会报莫名其妙的导入错误，记得把编辑器解释器指向项目环境。掌握这套流程，项目依赖就从靠记忆变成靠清单，新成员照着文档几分钟就能跑起项目。