virtualenvwrapper + pyenv 打造多版本 Python 环境

前言

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

virtualenvwrapper

安装

通过 pip 安装 virtualenvwrapper(Ps: 记住加上 sudo)。

1
$ sudo pip install virtualenvwrapper

配置

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

1
2
export WORKON_HOME=$HOME/.virtualenvs
source /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:

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

Mac OS X

使用 homebrew 直接安装:

1
2
$ brew update
$ brew install pyenv

配置

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

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

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

1
$ exec "$SHELL"

使用

1. 查看所有 Python 版本

1
$ pyenv versions

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

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

1
$ pyenv install -l

3. 安装与卸载

1
$ pyenv install 2.7.14

安装 Python 2.7.14 版本。

1
$ pyenv uninstall 2.7.14

卸载 Python 2.7.14 版本

1
$ pyenv rehash

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

4. 设置 Python 版本

1
2
3
$ 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 版本

1
2
$ pyenv shell --unset
$ pyenv local --unset

使用镜像加速下载

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

1
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:

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

Mac OS X

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

1
$ brew install pyenv-virtualenvwrapper

激活

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

1
$ pyenv virtualenvwrapper

使用

1
2
$ 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 安装配置与国内镜像加速
给我加个菜?