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、参考

推荐阅读更多精彩内容