在开发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版本:
- 使用
PYENV_VERSION
环境变量(如果存在). 你可以使用pyenv shell
命令来在当前shell环境中设置该环境变量. - 当前目录中应用程序指定的
.python-version
文件(如果存在). 你可以用pyenv local
命令来修改当前目录的.python-version
文件. - 自底向上搜索各层上级目录,找到的第一个
.python-version
, 直到到达文件系统根目录. - 全局的
$(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。