Python 环境总冲突?Mac / Windows 2 步隔离不再打架

想象一个常见的场景：你手上有两个 Python 项目，项目 A 依赖 requests==2.25.1，项目 B 依赖 requests==2.28.0。如果都在系统全局环境安装，先装 2.25.1，再装 2.28.0——版本升级了，项目 A 就跑不通了；反过来也一样。这就是版本冲突，在依赖多的大型项目里几乎不可避免。  除了版本打架，还有更隐蔽的问题：某个库卸载后残留的依赖、全局 pip install 装了一堆“试试看”的包导致环境臃肿、部署时因为本地环境和服务端不一致而疯狂报错……这些问题的根源都是——项目环境没有隔离。  用虚拟环境把每个项目的依赖圈在独立目录里，系统全局环境始终保持干净。好处总结：

Python 3.3 以后官方内置了 venv 模块（用法：python3 -m venv myenv），但 virtualenv 作为第三方工具，功能更完善、兼容性更好，社区里使用更广泛。下面以 virtualenv 为主讲解。

2.1 安装

安装完成后可以验证版本：

2.2 创建虚拟环境

先建一个存放虚拟环境的目录，然后在里面创建环境：

上面的 ENV 是虚拟环境的名字，可以自定义。执行后会在当前目录下生成一个 ENV 文件夹，里面有独立的 Python 解释器和 pip。  如果想指定 Python 版本创建，用 -p 参数：

2.3 激活虚拟环境

Mac/Linux 下激活：

激活成功后，终端提示符前面会出现 (ENV) 标识，表示你已经在虚拟环境里操作了。此时运行 which python，返回的路径应该是虚拟环境内的 Python，而不是系统的。

2.4 在虚拟环境里安装依赖

这些包只装在 ENV 目录的 site-packages 里，系统全局完全不受影响。

2.5 退出虚拟环境

退出后提示符 (ENV) 消失，python 和 pip 恢复为系统默认版本。

用 virtualenv 手动管理环境，需要记住每个环境的路径、手动 source 激活，环境多了容易混乱。virtualenvwrapper 是对 virtualenv 的封装，把所有虚拟环境统一放在一个目录下，提供快捷命令来创建、切换、删除环境，大幅降低管理成本。

3.1 安装

3.2 环境变量配置

安装后需要配置环境变量，告诉 virtualenvwrapper 用哪个 Python、把虚拟环境存到哪里。先查脚本位置：

然后编辑 ~/.zshrc（如果你用 bash 则编辑 ~/.bashrc），在末尾添加：

保存后执行 source ~/.zshrc 使配置生效。

3.3 常用命令

3.4 常见错误

错误一：报 `No module named virtualenvwrapper`  原因：系统默认 Python 是 2.7（macOS 自带），但 virtualenvwrapper 装在 Python 3 下。终端执行 virtualenvwrapper.sh 时用的是 Python 2.7，找不到模块。  解决：让 VIRTUALENVWRAPPER_PYTHON 指向 Python3 的真实安装路径，不要用软连接。用 which python3 或 ls /Library/Frameworks/Python.framework/Versions/ 找到真实路径。  错误二：初始化钩子报错  同样的问题——VIRTUALENVWRAPPER_PYTHON 指向了软连接而非真实路径。把变量值改成类似 /usr/local/python3/bin/python3 的真实地址即可。

虚拟环境搞好了，怎么让团队其他人或部署服务器快速复现同样的依赖？答案是 pip freeze。  导出当前环境的所有依赖到文件：

生成的 requirements.txt 内容类似：

在新环境里一键恢复：

Windows 用户注意：virtualenvwrapper 在 Windows 上有专门版本 virtualenvwrapper-win，命令略有差异。  安装：

验证安装：进入安装目录输入 .\workon，出现虚拟环境列表即安装成功。  配置 WORKON_HOME 环境变量（建议在系统环境变量中设置），指定虚拟环境存放目录，如 D:\python_env。如果不配置，默认建到 C:\Users\你的用户名\Envs\，路径太深不方便管理。  常用命令：

Linux 服务器是部署的主战场，虚拟环境同样必不可少。装到 /usr/local 下确保全局可用：

确认 virtualenv 可执行文件存在后，开始创建和使用：

which python 应该返回 venv 目录下的 Python 路径，说明虚拟环境激活成功。  停用：deactivate。多环境切换时要先停用当前环境、再激活另一个。  完整示例——创建两个环境并切换：

环境乱了，代码再对也跑不通。花十分钟把虚拟环境用顺，后面省下的是无数个排查依赖的下午。  三个平台做法不同但目的一样：Mac 用 virtualenvwrapper + zshrc，Windows 用 virtualenvwrapper-win，Linux 用 virtualenv + virtualenvwrapper + bashrc。核心流程都是：创建 → 激活 → 装依赖 → 导出依赖清单。  学习自动化测试，关注 测试逆转大师。