彻底搞懂 Python 虚拟环境,告别依赖冲突

uv（现代极速工具）：近年来业内非常流行的 Rust 开发的新一代包与环境管理工具，速度比传统的 pip 快几十甚至上百倍，适合追求极致效率的开发者。参考：别再傻等pip了！你该试试这个Python环境管理神器

三、 手把手：使用内置 venv 创建虚拟环境

接下来我们以 Python 内置的 venv 为例，介绍最基础、最通用的命令行操作：

1. 创建环境

进入你的项目根目录（命令行用 cd 命令切换），运行以下命令创建一个名为 .venv 的虚拟环境（文件夹名可自定义，前缀加点表示隐藏文件夹）：

python -m venv .venv

没有报错的话，项目目录下就会生成一个 .venv 文件夹，这就是隔离出来的虚拟环境。

2. 激活环境

创建完成后，需要“激活”环境，告诉系统接下来使用的 Python 和 pip 来自这个独立空间：

Windows 命令行（CMD / PowerShell）：

.venv\Scripts\activate

macOS / Linux 终端：

source .venv/bin/activate

激活成功后，终端命令行最左侧会出现 (.venv) 的括号标识。此时你再执行 pip install 安装任何库，都只会装进这个隔离空间，不会污染系统全局环境。

3. 关闭环境

当开发完毕或需要退出当前环境时，输入以下命令即可退出：

deactivate

四、 虚拟环境的底层原理

为什么简单几条命令就能实现隔离？本质上靠的是环境变量里的 PATH 路径。

当你在命令行输入 python 或 pip 时，系统会按照 PATH 变量中记录的目录顺序去查找可执行文件。

当激活虚拟环境时，系统会临时将该虚拟环境的 bin 或 Scripts 目录拼接到 PATH 的最前面。因此，系统会优先找到并调用虚拟环境里的 Python 解释器和 pip。

如果你不确定当前终端调用的究竟是哪里的 Python，可以使用命令进行确认：

Windows：

where python

macOS / Linux：

which python

五、 项目协作与 IDE 配置

在实际开发和团队协作中，还有几个非常关键的避坑细节：

1. 导出与还原依赖清单（requirements.txt）

虚拟环境隔离了依赖，但当你把代码分享给别人时，不需要把庞大的虚拟环境文件夹发过去。

导出依赖：在激活的环境下运行以下命令，把项目用到的库和精确版本记录到文本文件：

pip freeze > requirements.txt

一键还原：别人拿到你的代码后，只需新建虚拟环境并运行：

pip install -r requirements.txt

2. 切记不要将虚拟环境提交到 Git

虚拟环境体积大且包含本地路径依赖，绝对不要上传到代码仓库。请在项目的 .gitignore 文件中添加：

.venv/

3. 在 IDE 中关联虚拟环境

很多新手发现命令行装好了库，但在编辑器里代码依然报错，这是因为 IDE 没有正确选中解释器：

PyCharm：进入 Settings -> Project: 名称 -> Python Interpreter，点击添加解释器（Add Interpreter），选择 Existing 并指定刚才创建的 .venv 目录下的 Python 可执行文件。

VS Code：按下快捷键 Ctrl+Shift+P（Mac 为 Cmd+Shift+P），搜索并选择 Python: Select Interpreter，直接挑选当前项目目录下的 .venv 运行环境。

留个小作业：

亲自打开命令行，进入一个空目录，使用 python -m venv my_env 创建一个虚拟环境并激活它，尝试在里面安装一个第三方库（如 requests），体会一下独立空间的操作过程吧！

如果本文对你有帮助，欢迎点赞、评论、转发。你们的支持是我更新的动力~