Mac配置Python开发环境之pyenv和pyenv-virtualenv

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环境
• 官方文档