virtualenvwrapper + pyenv 打造多版本 Python 环境

前言

面对多个 Python 开发项目时，需要针对不同的项目创建相应的开发环境。通常情况下，使用 virtualenv 创建一个虚拟的独立 Python 环境，但是 virtualenv 创建的环境相对分散不便于管理。这里推荐使用 virtualenvwrapper 来创建集中的便于管理的 Python 环境，同时可以结合 pyenv 为不同的项目选定不同的 Python 版本。

virtualenvwrapper

安装

通过 pip 安装 virtualenvwrapper（Ps: 记住加上 sudo）。

$ sudo pip install virtualenvwrapper

配置

在.bashrc(或.zshrc)中添加下列内容：

export WORKON_HOME=$HOME
/.virtualenvssource /usr/local/bin/virtualenvwrapper.sh

接着执行`source ~/.bashrc(或./zshrc)。 注意：修改.bashrc还是.zshrc取决于你使用的那种 shell。

使用

• workon: 打印所有的虚拟环境；
• mkvirtualenv xxx: 创建 xxx 虚拟环境;
• workon xxx: 使用 xxx 虚拟环境;
• deactivate: 退出 xxx 虚拟环境；
• rmvirtualenv xxx: 删除 xxx 虚拟环境。

pyenv

安装

Linux

使用下列命令自动安装 pyenv:

$ curl -L https://raw.githubusercontent.com/pyenv/pyenv-installer/master/bin/pyenv-installer | bash

Mac OS X

使用 homebrew 直接安装：

$ brew update
$ brew install pyenv

配置

在.bashrc(或.zshrc)中添加下列内容：

export PYENV_ROOT="$HOME/.pyenv"
export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init -)"

然后重启 shell，使配置生效。

$ exec "$SHELL"

使用

1. 查看所有 Python 版本

$ pyenv versions

执行命令将打印出安装的所有 Python 版本，*表示当前使用的 Python 版本。

2. 查询所有可安装的 Python 版本

$ pyenv install -l

3. 安装与卸载

$ pyenv install 2.7.14

安装 Python 2.7.14 版本。

$ pyenv uninstall 2.7.14

卸载 Python 2.7.14 版本

$ pyenv rehash

创建垫片路径（为所有已安装的可执行文件创建 shims，如：~/.pyenv/versions//bin/，因此，每当你增删了 Python 版本或带有可执行文件的包（如 pip）以后，都应该执行一次本命令）。

4. 设置 Python 版本

$ pyenv shell 2.7.14  # 设置面向 shell 的 Python 版本，通过设置当前 shell 的 PYENV_VERSION 环境变量的方式。
$ pyenv local 2.7.14  # 设置 Python 本地版本，通过将版本号写入当前目录下的 .python-version 文件的方式。通过这种方式设置的 Python 版本优先级较 global 高。
$ pyenv global 2.7.14  # 设置全局的 Python 版本，通过将版本号写入 ~/.pyenv/version 文件的方式。

注意： shell > local > global。pyenv 会从当前目录开始向上逐级查找 .python-version 文件，直到根目录为止。若找不到，就用 global 版本。

Ps: 因为系统本身常常会依赖自带的 python 版本，所以尽量不要修改 global。

5. 取消 shell 或 local python 版本

$ pyenv shell --unset
$ pyenv local --unset

使用镜像加速下载

通过下列脚本使用国内搜狐的镜像快速安装各版本 Python：

v=3.5.2|wget http://mirrors.sohu.com/python/$v/Python-$v.tar.xz -P ~/.pyenv/cache/;pyenv install $v

注意：v 为 Python 版本号，请根据需要自行更改。

pyenv-virtualenvwrapper

安装

Linux

通过下列命令安装 pyenv-virtualenvwrapper:

$ git clone https://github.com/pyenv/pyenv-virtualenvwrapper.git $(pyenv root)/plugins/pyenv-virtualenvwrapper

Mac OS X

Mac OS X 下可选择使用使用 Homebrew 来安装：

$ brew install pyenv-virtualenvwrapper

激活

安装完成后使用下列命令激活 pyenv-virtualenvwrapper：

$ pyenv virtualenvwrapper

使用

$ pyenv local 2.7.14  # 设置本地 python 版本为 2.7.14
$ mkvirtualenv python2.7  # 创建 python 2.7.14 版本的虚拟环境 python2.7

参考

1. pyenv 文档
2. virtualenvwrapper 文档
3. pyenv-virtualenvwrapper 文档
4. 使用 pyenv 管理 Python 版本
5. pyenv 安装配置与国内镜像加速