Python 虚拟环境 venv 入门：隔离依赖的第一步

刚学 Python 时，很多人会把所有第三方库都装进系统 Python。起初一切正常，直到新建项目时提示版本冲突，旧项目也突然跑不起来了。问题往往不在代码，而在环境没有隔离。虚拟环境 venv，就是解决这个问题的第一步，也是 Python 开发者最值得先养成的习惯。

为什么需要隔离依赖

每个项目对依赖版本的要求并不相同。A 项目可能要 requests 2.28，B 项目却要 2.31；一个项目用 Django 4，另一个还停留在 Django 3。都装在同一个全局环境里，后装的版本会覆盖先装的，两个项目无法同时满足。虚拟环境为每个项目准备一套独立的解释器和包目录，互不干扰，出了问题也只影响当前项目。

venv 是什么

venv 是 Python 3.3 起内置的标准库，不用额外安装。它在项目目录下建立独立的包安装目录，激活后，命令行里的 python 和 pip 都会指向当前环境，之后安装的包只进入这个环境。退出后，一切恢复原样。

三步创建一个环境

第一步，在项目根目录执行 python -m venv .venv 创建环境。第二步激活它：Windows 上执行 .venv\Scripts\activate，macOS 或 Linux 上执行 source .venv/bin/activate，成功后提示符前会出现 (.venv)。第三步安装依赖，例如 pip install requests，再用 pip freeze > requirements.txt 冻结版本。

日常使用的小习惯

用完执行 deactivate 退出，不要在错误的解释器里装包。每次安装或升级依赖后，及时更新 requirements.txt。不要把 .venv 提交到代码仓库，应在 .gitignore 里加上 .venv/；环境坏了直接删除文件夹重建即可，项目代码不会受影响。

结语

隔离依赖不是进阶技巧，而是写 Python 的基本功：一个项目一个环境，一份 requirements.txt 记录版本，遇到冲突先看环境再看代码。把这个习惯固定下来，以后做练习项目、参与开源或部署到服务器，都会少走很多弯路。