Python 虚拟环境入门：三分钟搞懂 venv 的日常用法

刚学 Python 时大家常把包装在系统全局环境里，日子久了就会遇到经典问题：项目 A 要求 requests 2.25，项目 B 却依赖 2.31，卸了装、装了卸，最后谁也跑不起来。虚拟环境就是为解决这个问题而生的：给每个项目一个独立的依赖目录，互不干扰。Python 3 自带的 venv 模块无需安装任何第三方工具，三分钟就能上手。

一、创建与激活

在项目根目录执行：

python3 -m venv .venv

这会生成一个 .venv 目录，里面是独立的解释器和 pip。不同系统的激活命令不同：

# macOS / Linux
source .venv/bin/activate

# Windows (PowerShell)
.venv\Scripts\activate

激活成功后，命令行提示符前面会出现 (.venv) 标识，此时 python 和 pip 都指向虚拟环境内的版本，pip install 装的包也只进入当前项目。

二、日常三件套

pip install requests        # 安装包
pip list                    # 查看已装包
pip freeze > requirements.txt   # 导出依赖清单

同事拿到你的代码后，只需三行命令即可还原一模一样的环境：

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

三、几个实用习惯

• 把 .venv 目录写进 .gitignore，仓库里只保留 requirements.txt，不要把环境文件提交上去；
• 用 python -m pip 代替直接敲 pip，确保 pip 永远和当前 python 版本配套；
• 再小的项目也值得单独建环境，一个环境只占几 MB，远比事后排查依赖冲突省时间。

结语：虚拟环境不是可选项，而是 Python 开发的基本功。掌握"建环境、激活、导出依赖"这三步，日常 90% 的依赖管理问题都能避免。等熟悉之后，再进阶了解 poetry、uv 等更现代的工具也会非常顺手。