pyenv快速入门

在开发Python程序的时候，有时候可能需要在不同版本的Python上进行测试。pyenv就是这么一个管理多版本Python的工具。由于在Windows中我们可以同时安装多个版本的Python，所以这里是在Linux下介绍该工具。

安装

首先当然是安装pyenv了，最简单的办法就是利用官方Github仓库中的安装脚本了：

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

安装脚本有可能会提示你手动把几行命令添加到shell的配置文件中。

如果你用的是zsh的话，别忘了替换命令中的bash。将来如果要删除的话，需要在.zshrc文件中删除。如果你用oh-my-zsh的话，不需要在.zshrc中添加那几行（加了也没用），而是在.zshrc中启用pyenv插件。

将来要进行更新的话：

$ pyenv update 

要卸载pyenv的话更加简单，直接删除目录即可：

$ rm -fr ~/.pyenv 

别忘了把.bashrc中的这几行也一并删掉：

export PATH="~/.pyenv/bin:$PATH" eval "$(pyenv init -)" eval "$(pyenv virtualenv-init -)" 

工作原理

Linux环境变量

当执行命令的时候，系统会在环境变量中从左到右依次寻找匹配的命令并执行。环境变量中是一组以冒号:分隔的路径。

垫片（Shims）

pyenv的工作原理其实很简单，将它自己管理的Python目录插到环境变量的最前面，这样一来系统在搜索Python的时候第一个找到的就是pyenv管理的Python环境。这个插到最前面的路径就叫做垫片（shims），当然这是在英文语境下，在中文环境下我老觉得怪怪的，反正理解意思就好。

选择Python版本

当执行pyenv命令的时候，它会按照以下顺序来决定要使用的Python版本：

1. 使用PYENV_VERSION环境变量(如果存在). 你可以使用pyenv shell 命令来在当前shell环境中设置该环境变量.
2. 当前目录中应用程序指定的.python-version文件(如果存在). 你可以用pyenv local 命令来修改当前目录的.python-version文件.
3. 自底向上搜索各层上级目录，找到的第一个.python-version, 直到到达文件系统根目录.
4. 全局的$(pyenv root)/version文件. 可以使用 pyenv global 命令来修改. 如果全局版本文件不存在, pyenv假设你使用系统安装的Python. (换句话说就是未安装pyenv时环境变量中找到的Python.)

常用命令

完整命令请参考官方文档。

安装

列出所有可安装的Python版本：

pyenv install -l|--list 

安装某个Python：

pyenv install <version> 

卸载

卸载某个Python，-f参数指定是否强制卸载，如果强制卸载的话不会弹出提示，而且如果版本不存在的话也不会显示错误信息：

pyenv uninstall [-f|--force] <version> 

versions

列出所有已安装的Python，当前使用的Python会用星号标出：

$ pyenv versions 2.5.6 2.6.8 * 2.7.6 (set by /home/yyuu/.pyenv/version) 3.3.3 jython-2.5.3 pypy-2.2.1 

global

通过写~/.pyenv/version文件的方式设置全局Python：

$ pyenv global 2.7.6 

local

通过在当前目录写.python-version文件的方式设置当前目录下的Python：

pyenv local 2.7.6 

当不再需要本地Python的时候，用--set来清除：

$ pyenv local --unset 

shell

指定当前shell使用的Python：

$ pyenv shell pypy-2.2.1 

当不再需要的时候，用--set来清除：

$ pyenv shell --unset 

最后展示一下pyenv install -l的输出，可以看到，pyenv可以方便的安装大部分版本的Python，省略号表示中间有一大堆：

yitian@ubuntu:~ $ pyenv install -l Available versions: 2.1.3 ... 2.7.15 ... 3.6.6 3.7.0 3.7-dev 3.8-dev activepython-2.7.14 activepython-3.5.4 activepython-3.6.0 anaconda-1.4.0 ... anaconda3-5.2.0 ironpython-dev ironpython-2.7.4 ironpython-2.7.5 ironpython-2.7.6.3 ironpython-2.7.7 jython-dev jython-2.5.0 jython-2.5-dev jython-2.5.1 jython-2.5.2 jython-2.5.3 jython-2.5.4-rc1 jython-2.7.0 jython-2.7.1 micropython-dev micropython-1.9.3 micropython-1.9.4 miniconda-latest miniconda-2.2.2 ... miniconda3-4.3.30 pypy-c-jit-latest pypy-c-nojit-latest pypy-dev pypy-stm-2.3 pypy-stm-2.5.1 pypy-1.5-src pypy-1.5 ... pypy3.5-6.0.0 pyston-0.5.1 pyston-0.6.0 pyston-0.6.1 stackless-dev stackless-2.7-dev stackless-2.7.2 ... stackless-3.5.4 

常见问题

用pyenv安装Python的时候可能会出现各种各样问题，例如缺少zlib、缺少ctypes模块等等。对此pyenv也有专门一个页面解决。对于我的Ubuntu 18.04虚拟机来说，安装以下一坨软件可以解决问题：

sudo apt-get install -y make build-essential libssl-dev zlib1g-dev libbz2-dev \ libreadline-dev libsqlite3-dev wget curl llvm libncurses5-dev libncursesw5-dev \ xz-utils tk-dev libffi-dev liblzma-dev libedit-dev 

其他系统请查看pyenv的页面，如果有其它问题请自行搜索Stack Overflow。