pyenv快速入门

曾经终败给现在 2022-05-09 00:24 207阅读 0赞

在开发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环境变量 ###

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

![环境变量][1240]

### 垫片（Shims） ###

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

### 选择Python版本 ###

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

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

## 常用命令 ##

完整命令请参考[官方文档][Link 1]。

### 安装 ###

列出所有可安装的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也有专门一个[页面][Link 2]解决。对于我的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][]。

[1240]: /images/20220509/5448f9a430304afba1d9f705f37e90e8.png
[pyenv shell]: https://github.com/pyenv/pyenv/blob/master/COMMANDS.md#pyenv-shell
[pyenv local]: https://github.com/pyenv/pyenv/blob/master/COMMANDS.md#pyenv-local
[pyenv global]: https://github.com/pyenv/pyenv/blob/master/COMMANDS.md#pyenv-global
[Link 1]: https://github.com/pyenv/pyenv/blob/master/COMMANDS.md
[Link 2]: https://github.com/pyenv/pyenv/wiki/common-build-problems
[Stack Overflow]: https://stackoverflow.com/