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