Python 虚拟环境 venv 入门：三个命令管好项目依赖

装包装到依赖打架？同一个包 A 项目要 2.0、B 项目要 1.9，全局环境里只能装一个，于是 import 报错找上门。解法就是虚拟环境：给每个项目一个独立、干净的 Python 小世界，venv 是 Python 3 自带的官方方案，不用装任何第三方工具。

一、创建与激活

在项目根目录执行 python -m venv .venv，几秒后目录里会多出一个 .venv 文件夹，独立的解释器和 pip 都在里面。激活方式按平台区分：macOS/Linux 执行 source .venv/bin/activate，Windows PowerShell 执行 .venv\Scripts\Activate.ps1。激活成功后命令行前面会多出 (.venv) 前缀，此时 pip install 装的包只属于这个项目。

二、依赖锁定与还原

项目能跑起来后，用 pip freeze > requirements.txt 把当前环境里的包和版本号写进文件，这就是依赖锁定。别人拿到项目后，创建自己的虚拟环境，再执行 pip install -r requirements.txt 就能还原出一模一样的环境，"在我电脑上能跑"的问题从根源上消失。

三、三个好习惯

• .venv 目录加进 .gitignore，它只服务本机，提交上去只会污染仓库；
• 一个项目一个 venv，多个项目共用一个环境迟早回到依赖打架；
• 卸载包前先确认自己处在正确的虚拟环境里，pip -V 的路径能看出当前用的是哪个环境的 pip。

结语：venv 只有创建、激活、锁定三步，成本不到一分钟，换来的是每个项目依赖互不干扰。从下一个项目开始，先 venv 再写代码。