12.7 【最强工具】方案六：pyenv

前面介绍过非常地 Python 包管理工具，有 pip、 venv、pipenv、poetry、pdm 等

今天来介绍一个更高层次的管理工具，可以直接管理 Python 解释器的版本，同时也可以管理虚拟环境，它就是 pyenv。

pyenv 的一个典型使用场景就是，比如一个老项目需要使用 Python 2.x ，而另一个新项目需要 Python 3.x 。而 virtualenv 主要是用来管理相同版本 Python 不同项目的包的依赖不同的问题，就无法解决这个问题，这个时候就需要 pyenv。

有了 pyenv，你可以一键安装、切换到任意你需要的 python 版本，从 2.1.3 -> 3.12-dev（稿前为止最新版本）。

除了常规的 CPython 之外，它还可以管理其他的 python 和 工具，包括：

  • graalpython

  • ironpython

  • jython

  • micropython

  • pypy

  • miniconda

  • anaconda

  • pyston

  • stackless

  • 等等

好家伙，我愿称之为 Python Env Master，而上面每个工具，还有细分的版本，不用担心，pyenv 全部都有收录，可以满足你几乎所有需求了。

1. 安装与配置

先安装 pyenv，由于我使用 macOS，使用 brew 可以很方便的安装它

brew update
brew install pyenv

安装 pyenv 会安装相当多的依赖包，包括：

  • pyenv: pyenv 工具自身

  • pyenv-update: 用来更新 pyenv 的插件

  • pyenv-doctor: 验证 pyenv 和依赖是否安装的插件

  • pyenv-which-ext: 用来寻找相同命令的插件

使用 pyenv help 查看一下帮助命令，如果没有报错，说明安装成功

https://image.iswbm.com/20221211183415.png

另外，除了 pyenv，还要安装一个插件 pyenv-virtualenv，它是专门用来管理 vitual environments 的

brew install pyenv-virtualenv

安装好后，还要进行一下初始化。

为了下次新开终端也可以立马使用 pyenv，可以将下面两条初始化命令写入 .bash_profile或 .zshrc（根据自己实际情况而定）

eval "$(pyenv init -)"
eval "$(pyenv virtualenv-init -)"

然后再次执行 source 使之立即执行

source ~/.bash_profile
# 或
source ~/.zshrc

2. 基本使用

环境配置好后，那如何知道有哪些版本可以安装呢？

可以使用如下命令查询所有可安装的项

pyenv install --list

比如我现在需要安装的是 python3.8，但我不知道最新的小版本是多少，就可以使用上面命令查询一下

https://image.iswbm.com/20221211205459.png

发现最新的版本是 3.8.16，于是直接使用 install 来安装它，再使用 pyenv versions 就可以看到我们安装的版本了。

https://image.iswbm.com/20221211183934.png

从上面截图可以看到，安装完后并不会自动切换过去，目前还是指向系统自带的 Python，需要手动进行版本的切换，切换方法有如下两种：

pyenv global 3.8.16
# 或
pyenv local 3.8.16

那这种有什么区别呢？简单来说：

  • global：设置全局的 Python 解释器，不管你在任何路径下都是使用该版本的 Python

  • local： 设置的是某特定目录（或项目）的 Python 解释器，只有在该目录下才能用该版本的 Python

我们使用 pyenv versions 可以观察下指向的 Python 版本，可以发现

  • 只要进入 wechat-chatgpt 目录，就会使用 .python-version里的解释器

  • 一旦离开 wechat-chatgpt 目录，就又会使用全局的 Python 解释器

https://image.iswbm.com/20221211211322.png

想要切换回系统自带的 Python ，也是同样道理，将版本换成 system 即可

pyenv global system

3. 虚拟环境

pyenv 管理的每一个版本在 ~/.pyenv/versions 下都有对应的目录

https://image.iswbm.com/20221211212217.png

当然 pyenv 创建的虚拟环境也是在这下面，只不过我还没有创建过虚拟环境。

现在使用使用如下命令创建一个

pyenv virtualenv 3.8.16 wechat-chatgpt

可以发现不管在 ~/.pyenv/versions目录下还是 pyenv versions都会新增一个环境

https://image.iswbm.com/20221211212513.png

只要在对应的目录下使用 local 指定 Python 版本，就实现了项目与 Python 版本的绑定。实在是太友好啦～

https://image.iswbm.com/20221211212735.png

另外列几个虚拟环境管理的命令

  • 查看所有虚拟环境：pyenv virtualenvs

  • 删除指定虚拟环境：pyenv virtualenv-delete

  • 查看虚拟环境的真实的 Python 环境：pyenv virtualenv-prefix

4. 总结一下

pyenv 从解释器管理到虚拟环境管理，给了 Python 工程师一站式的体验，对于那些需要维护很多项目并且有些项目依赖了不同的 Python 版本的人来说，请一定在你的电脑上安装 pyenv，因为它实在太方便了。

目前我发现的唯一的不足，可能就是它只能管理通过 pyenv 安装的解释器，而对于系统上早已存在的 Python 解释器，并不会去扫描纳管，但这问题实在太小，小到可以忽略不计。