本文共 1639 字，大约阅读时间需要 5 分钟。

使用 virtualenv 和 virtualenvwrapper 管理 Python 虚拟环境。

macOS 版本：macOS Big Sur 11.4。

Python 版本 Python 3.7+

1. Python 虚拟环境介绍

由于系统中可能存在多个 Python 版本（比如我我的 Mac 由于之前安装 Anaconda 等原因，Python 版本有些混乱），或者在不同的应用环境下，依赖的 Python 环境可能相互冲突（比如 应用A 可能依赖 XX 版本 numpy，但是 应用B 可能依赖另一个版本的 numpy）。

这时，可以使用 虚拟环境 的概念来构建不同应用背景下的 Python 环境。

所谓虚拟环境是一个包含了特定 Python 解析器以及一些软件包的自包含目录，不同的应用程序可以使用不同的虚拟环境，从而解决了依赖冲突问题，而且虚拟环境中只需要安装应用相关的包或者模块，可以给部署提供便利。

虚拟环境更具体的原理解释详见参考文献。

当前也有很多的虚拟环境的构建、管理解决方案，这里介绍使用 virtualenv 和 virtualenvwrapper 管理 Python 虚拟环境。

2. Virtualenv 和 Virtualenvwrapper 的安装和配置

2.1 安装 Virtualenv 和 Virtualenvwrapper

可以使用 pip 安装安装 virtualenv 和 virtualenvwrapper 到电脑中：

pip3 install virtualenv virtualenvwrapper

默认情况下 pip 使用的是国外镜像，国内的同学可能下载速度过慢，此时可以。

2.2 配置 Virtualenv 和 Virtualenvwrapper

之后，需要在系统配置文件 ~/.bash_profile 中添加配置内容。使用 vim （或 nano 等应用）打开该文件：

vim ~/.bash_profile

将下列内容添加到文件末尾：

# virtualenv and virtualenvwrapperexport WORKON_HOME=$HOME/.virtualenvsexport VIRTUALENVWRAPPER_PYTHON=/usr/local/bin/python3    # 此处可能修改，详见下面注释。source /usr/local/bin/virtualenvwrapper.sh  # 此处可能修改，详见下面注释。

保存文件后，在终端中运行下面命令：

source ~/.bash_profile

注意： 由于我之前乱七八糟安装/卸载过多次相关软件包，使得出现了 /Users/XXX/.bash_profile:source:11: no such file or directory: /usr/local/bin/virtualenvwrapper.sh 的错误，此时需要通过在终端中运行 which virtualenvwrapper.sh 的命令，确定其地址并对添加内容的第2行和第3行进行修改。

2.虚拟环境管理示例

virtualenvwrapper 提供了一些常见的命令，可以用于配置虚拟环境。

• mkvirtualenv：创建一个新的虚拟环境；
• workon：激活/转换到一个虚拟环境中；
• deactivate：退出虚拟环境，回到自己的系统中；
• rmvirtualenv：删除虚拟环境。

比如这里创建一个名为 cv_test 的 Python3 的虚拟环境：

mkvirtualenv cv_test -p python3

可以看到，此时命令行的最前面增加了一个括号，显示为(cv_test)，表示此时已在此虚拟环境下工作了。