1、Pyenv简介
pyenv可以解决多个python环境共存的问题，是一个便捷的python版本管理工具。
2、Pyenv的安装
安装pyenv和pyenv-virtualenv两个包，用到了brew命令，Mac新电脑并没有安装homebrew，可以参考Mac安装brew并更改源
$ brew install pyenv
$ brew install pyenv-virtualenv
安装完成后pyenv命令还没有添加进系统的环境变量，需要在shell配置文件中添加以下内容（我使用的是zsh，所以需要在~/.zshrc中添加）
export PYENV_ROOT="$HOME/.pyenv"
export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init -)"
eval "$(pyenv virtualenv-init -)"
有的资料指出，在shell配置文件（我使用的是zsh，所以需要在~/.zshrc中添加）中添加以下几行内容
export PYENV_ROOT="$HOME/.pyenv"
export PATH="$PYENV_ROOT/bin:$PATH"
if command -v pyenv 1>/dev/null 2>&1; then
eval "$(pyenv init -)"
fi
if which pyenv-virtualenv-init > /dev/null;
then eval "$(pyenv virtualenv-init -)";
fi
经验证，以上两种方法均可行，第二种只是进行了判断，第一种是直接执行了后两句命令。添加好以上几行代码之后，在终端中执行如下命令
$ source ~/.zshrc
3、Pyenv基本操作
3.1 查看目前所有版本的python
$ pyenv versions
结果应当类似于
* system (set by /Users/wangkaiju/.python-version)
2.7.10
3.7.0
3.2 查看当前版本的python
$ pyenv version
显示的结果为当前使用的python版本，结果类似于
system (set by /Users/wangkaiju/.python-version)
3.3 设置全局的python环境
设置全局变量为system
$ pyenv global system
设置全局变量为python3.7.0
$ pyenv global 3.7.0
3.4 设置局部的python环境
注意:local优先级要高于global
设置局部python环境为system
$ pyenv local system
设置局部python环境为2.7.10
$ pyenv local 2.7.10
3.5 设置shell的python环境
注意：shell优先级高于local
设置shell的python环境为3.7.0
$ pyenv shell 3.7.0
3.6 重置环境
重置local环境
$ pyenv local --unset
重置shell环境
$ pyenv shell --unset
4、安装不同版本的python
4.1 查看pyenv支持的所有python列表
$ pyenv install --list
4.2 安装特定版本的python
$ pyenv install 3.5.2
4.3 卸载特定版本的python
$ pyenv uninstall 3.5.2
4.4 刷新$PATH变量
新安装或者卸载指定版本python后都要执行以下命令，刷新$PATH变量
$ pyenv rehash
4.5 安装指定版本python出现错误
ERROR: The Python ssl extension was not compiled. Missing the OpenSSL lib
用如下命令解决
$ CFLAGS=-I/usr/include/openssl-1.0 \
$ LDFLAGS=-L/usr/lib64/openssl-1.0 \
$ pyenv install 3.5.2
参考: Compiling Python via Pyenv on Archlinux but missing OpenSSL
5、不同项目虚拟环境的搭建
利用pyenv virtualenv命令就可以管理多个依赖库环境，命令使用格式为：
pyenv virtualenv PYTHON_VERSION PROJECT_NAME
说明：用以上命令格式创建的python环境，位于~/.pyenv/versions/，其中PYTHON_VERSION是具体的python版本号，例如3.6.0，PROJECT_NAME 是我们自定义的项目名称。比较好的实践方式是，在 PROJECT_NAME 也带上 Python 的版本号，以便于识别。现假设我们有 XDiff 这么一个项目，想针对 Python 2.7.13 和 Python 3.6.0 分别创建一个虚拟环境，那就可以依次执行如下命令
$ pyenv virtualenv 3.6.0 py36_XDiff
$ pyenv virtualenv 2.7.10 py27_XDiff
创建完新环境后，使用如下命令查看本地所有的项目环境
$ pyenv virtualenvs
切换到新的环境py36_XDiff
$ pyenv activate py36_XDiff
切换到新的环境py27_XDiff
$ pyenv py27_XDiff
退回到系统环境
$ pyenv deactivate
卸载创建的python环境
## 方式一：暴力删除
$ rm -rf ~/.pyenv/versions/py36_XDiff
## 方式二：温柔卸载
$ pyenv uninstall py36_XDiff
说明： uninstall 的命令不能完全卸载完, 可以使用删除的方式
6、项目实践举例
假设现在有一个项目同时尝试使用python3.5.2和3.3.2进行编写，流程如下
# 进入目录
cd ./Downloads
# 创建项目目录并进入
mkdir Mao & cd Mao
# 接下来有两种方法, 一种用 local 变量, 另一种用 virtualenv 方式
local 变量法
# 进入 3.5.2 的环境, 并安装必要的软件包, 进行测试
pyenv local 3.5.2 & pip install package
# 进入 3.3.2 的环境, 并安装必要的软件包, 进行测试
pyenv local 3.3.2 & pip install package
virtualenv 法
# 创建两个虚拟环境
pyenv virtualenv 3.6.0 py36_Mao
pyenv virtualenv 2.7.13 py33_Mao
# 进入 3.5 环境进行工作
pyenv activate py35_Mao
# 进入 3.3 环境进行工作
pyenv activate py33_Mao
# 结束后离开虚拟环境
pyenv deactivate
# 如果以后不再使用虚拟开发环境, 删除环境
rm -rf ~/.pyenv/versions/py35_Mao/
rm -rf ~/.pyenv/versions/3.5.2/envs/py35_Mao
rm -rf ~/.pyenv/versions/py33_Mao/
rm -rf ~/.pyenv/versions/3.3.2/envs/py33_Mao
7、参考
- Python-Pyenv 使用方法总结
- 使用pyenv与pyenv-virtualenv管理python环境
- 官方文档