Python 虚拟环境入门：为什么你的项目总要 venv

刚装好 Python 就直接 pip install，过几个月突然发现某个库升级后另一个项目跑不起来了——这是几乎每个初学者都会踩的坑。虚拟环境（venv）就是解决这个问题的标准做法。

一、为什么需要虚拟环境

Python 的第三方包默认装进全局环境。所有项目共享同一套包版本：项目 A 依赖 requests 2.28，项目 B 却需要 2.31，全局只能装一个，必然有一个项目出问题。虚拟环境为每个项目创建一套独立、隔离的包目录，互不干扰。

二、三分钟上手 venv

Python 3.3 起内置了 venv 模块，无需安装任何东西：

# 创建虚拟环境（生成 .venv 文件夹）
python -m venv .venv

# 激活（Windows PowerShell）
.venv\Scripts\Activate.ps1

# 激活（macOS / Linux）
source .venv/bin/activate

# 激活后安装的包都只属于这个环境
pip install requests

激活后命令行前面会出现 (.venv) 标记。用 deactivate 退出。

三、依赖清单：requirements.txt

团队协作或换电脑时，把环境"打包"成清单即可：

pip freeze > requirements.txt   # 导出
pip install -r requirements.txt # 还原

四、两个常见误区

1）把 .venv 文件夹提交进 Git——它体积大且不可移植，正确做法是写入 .gitignore，只提交 requirements.txt；2）用系统 Python 的 pip 装包不加 --user 或虚拟环境，可能触发权限问题或污染全局，初学者建议一律在虚拟环境内操作。

小结

虚拟环境是 Python 工程化的第一步：一个项目一个 venv，依赖用 requirements.txt 管理，就能避免绝大多数"我这能跑你那不行"的问题。