pyenv 管理 python 多版本

1：virtualenv

  • virtualenv 所要解决的是同一个库不同版本共存的兼容问题。例如项目 A 需要用到 requests 的 1.0 版本，项目 B 需要用到 requests 的 2.0 版本。如果不使用工具的话，一台机器只能安装其中一个版本，无法满足两个项目的需求。

  • virtualenv 的解决方案是为每个项目创建一个独立的虚拟环境，在每个虚拟环境中安装的库，对其他虚拟环境完全无影响。所以就可以在一台机器的不同虚拟环境中分别安装同一个库的不同版本。

  • virtualenv 在使用方法上也比较简单：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

# 安装 virtualenv
pip install virtualenv
# 创建虚拟环境 myenv
virtualenv /path/to/myenv
# 切换到虚拟环境 myenv，此时命令提示符前会有 (myenv) 提示符
cd /path/to/myenv/ && source bin/activate
# 安装库，安装到 /path/to/myenv/lib 中，不会与其他虚拟环境冲突
pip install requests
# 执行 python 相关命令
python demo.py
# 退出虚拟环境
deactivate

2: pyvenv

  • pyvenv 与 virtualenv 功能和用法类似。不同点在于：
    • 1: pyvenv 只支持 Python 3.3 及更高版本，而 virtualenv 同时支持 Python 2.x 和 Python 3.x；
    • 2: pyvenv 是 Python 3.x 自带的工具，不需要安装，而 virtualenv 是第三方工具，需要安装;
    • 3: pyvenv 实际上是 Python 3.x 的一个模块 venv，等价于 python -m venv
  • pyvenv 的用法和 virtualenv 类似:
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

# 创建虚拟环境 myenv
pyvenv /path/to/myenv
# 或者
python -m venv /path/to/myenv
# 切换到虚拟环境 myenv，此时命令提示符前会有 (myenv) 提示符
cd /path/to/myenv/ && source bin/activate
# 安装库，安装到 /path/to/myenv/lib 中，不会与其他虚拟环境冲突
pip install requests
# 执行 python 相关命令
python demo.py
# 退出虚拟环境
deactivate

3：pyenv

3.1 pyenv 管理多个 python 版本

  • 与上述两个工具不同，pyenv 不是用来管理同一个库的多个版本，而是用来管理一台机器上的多个 Python 版本。主要解决开发中有的项目需要用 Python 2.x，有的项目需要用 Python 3.x 的场景。

  • 网上有很多教程，讲如何在一台机器上同时安装 2.x 和 3.x 两个版本，使用时分别用 python、python3 区分。但是这种方法有几个明显的缺点： 安装麻烦：源码手动安装，可能需要手动指定安装路径，创建软连接等； 2.x 和 3.x 分别只能安装一个版本：例如不能同时安装 2.6 和 2.7； 需要人工确定项目使用的 Python 版本，指定错误会导致运行报错。

  • pyenv 支持在一台机器上同时安装 cpython（平时说的 Python）、jython、anaconda、micropython、miniconda、pypy、stackless 等等的任意当前可用版本，例如可以同时安装 Python 2.6.9、2.7.15、3.6.6、3.8-dev 几个版本。

  • pyenv 使用了垫片的原理，可以做到进入项目目录自动选择 Python 版本，使用极为方便，这也是我目前正在使用的工具

  • pyenv 的使用方法:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21

# 安装 pyenv（推荐方法，此脚本会自动安装若干插件，包括下文即将提到的 pyenv virtualenv）
curl -L https://github.com/pyenv/pyenv-installer/raw/master/bin/pyenv-installer | bash
curl https://pyenv.run | bash

pyenv --version # 查看pyenv版本
pyenv update # 升级


pyenv versions # 本地可用可用python版本
pyenv install -list # 查看所有可用的Python版本
pyenv install 3.7.0 # 安装指定版本
pyenv uninstall 3.7.0  # 卸载指定版本

pyenv version # 当前活动的Python版本
pyenv shell 3.7.0 # 当前shell
pyenv local 3.7.0 # 当前目录
pyenv global 3.7.0 # 全局

pyenv shell --unset # 取消设置
pyenv local --unset # 取消设置
pyenv global --unset # 取消设置

3.2 pyenv virtualenv

  • pyenv 引入了了 virtualenv 插件，可以在 pyenv 中解决同一个库的版本管理问题;
  • 通过 pyenv virtualenv 命令，可以与 virtualenv 类似的创建、使用虚拟环境。但由于 pyenv 的垫片功能，使用虚拟环境跟使用 Python 版本的体验一样，不需要手动执行 activate 和 deactivate，只要进入目录即生效，离开目录即失效;
  • pyenv virtualenv 的用法和 pyenv 类似（使用上述安装 pyenv 方法会自动安装 virtualenv 插件）：
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

# 分别安装基于 Python 2.7.17 和 Python 3.8.2 的虚拟环境
pyenv virtualenv 2.7.17 .venv-2.7.17
pyenv virtualenv 3.8.2 venv3-3.8.2
# 指定全局使用虚拟环境 venv2
pyenv global venv2
# 指定 myproject 使用虚拟环境 venv3
cd myproject
pyenv local venv3
# 在当前 shell 中临时使用虚拟环境 venv3
pyenv shell venv3

# 查看当前的pyenv虚拟环境
pyenv virtualenvs

# 删除venv
pyenv uninstall .venv-3.10.16

4: 在 Ubuntu 22.04 上用 pyenv 管理 Python 版本，并配合 pyenv-virtualenv 创建虚拟环境的案例

  • 在 Ubuntu 22.04 上用 pyenv 管理 Python 版本，并配合 pyenv-virtualenv 创建虚拟环境的标准案例

4.1 安装 pyenv

4.2 先确认当前 shell 里 pyenv 是否真正生效

1
2
3

echo $SHELL
which pyenv
type pyenv  # 如果 type pyenv 显示函数/初始化信息，说明 shell 集成已经开始起作用

4.3 Ubuntu 22.04 安装 pyenv 依赖

1
2
3
4
5
6
7

apt update
apt install -y \
  make build-essential libssl-dev zlib1g-dev libbz2-dev \
  libreadline-dev libsqlite3-dev wget curl llvm \
  libncursesw5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev \
  libffi-dev liblzma-dev git
# 这些是pyenv 编译Python时的常用依赖

4.4 配置 pyenv 到 zsh

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

# 如果你用的是 zsh，编辑 ~/.zshrc，加入：
export PYENV_ROOT = "/root/.pyenv"
export PATH       = "$PYENV_ROOT/bin:$PYENV_ROOT/shims:$PATH"
eval "$(pyenv init - zsh)"

source ~/.zshrc

# 验证
which pyenv
pyenv --version
which python3

# 注意: which python3 不一定立刻变成 pyenv 的版本，必须先设置 pyenv 的版本

4.5 安装你想要的 Python 版本

1
2
3
4
5

pyenv install -l # 查看版本list
pyenv install 3.10.14 # 安装指定版本
pyenv install 3.12.9 # 安装指定版本
pyenv install 3.9.25 # 安装指定版本
pyenv versions # 查看已安装的版本

4.6 设置默认 Python 版本

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

pyenv global 3.10.14 # 全局默认

exec $SHELL # 刷新当前 shell

# 再验证
python --version
python3 --version
which python
which python3

# 如果 pyenv 接管成功，which python3 应该会指向：
/root/.pyenv/shims/python3

4.7 安装 pyenv-virtualenv

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

# 安装 pyenv-virtualenv
#  $(pyenv root)/plugins/pyenv-virtualenv 目录已存在，可能直接安装好了
git clone https: //github.com/pyenv/pyenv-virtualenv.git $(pyenv root)/plugins/pyenv-virtualenv

# 在 ~/.zshrc 加
eval "$(pyenv virtualenv-init -)"

# pyenv .zshrc 完整配置
export PYENV_ROOT = "/root/.pyenv"
export PATH       = "$PYENV_ROOT/bin:$PYENV_ROOT/shims:$PATH"
eval "$(pyenv init - zsh)"
eval "$(pyenv virtualenv-init -)"

source ~/.zshrc

4.8 创建虚拟环境

1
2
3

# 假设你已经安装了 3.10.14
pyenv virtualenv 3.10.14 myenv # 这会创建一个名为 myenv 的虚拟环境
pyenv virtualenvs # 查看所有虚拟环境

4.9 使用虚拟环境

4.9.1 当前目录绑定虚拟环境

1
2
3
4
5
6

cd /path/to/your/project
pyenv local myenv # 它会生成一个 .python-version 文件，之后进入该目录时自动使用 myenv

# 验证
python --version
which python

4.9.2 手动激活

1
2

pyenv activate myenv # 激活虚拟环境
pyenv deactivate # 退出虚拟环境

4.10 常见问题

4.10.1 为什么 which python3 还是/usr/bin/python3?

通常原因是:

  • 没有执行pyenv init;
  • 没有把 shims 放到 PATH 前面;
  • 没有设置 pyenv global/local;
1
2
3
4
5

# 你应该确认：
echo $PATH
是否有:
/root/.pyenv/shims
/root/.pyenv/bin

4.10.2 为什么 python3 还是系统版本，但 python 已变？

  • 有些系统默认 python3 还是系统命令，pyenv 主要通过 shims 接管，正常情况下会同时接管 python 和 python3，但前提是版本设置和初始化都正确

4.10.3 如果 shell 改动后不生效

1
2

hash -r
exec $SHELL

4.12 pyenv 完整操作流程

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

# 1. 安装 pyenv（推荐方法，此脚本会自动安装若干插件，包括下文即将提到的 pyenv virtualenv）
curl -L https://github.com/pyenv/pyenv-installer/raw/master/bin/pyenv-installer | bash
curl https://pyenv.run | bash

pyenv --version # 查看pyenv版本
pyenv update # 升级


pyenv versions # 本地可用可用python版本

# 2. 安装依赖
apt update
apt install -y make build-essential libssl-dev zlib1g-dev libbz2-dev \
  libreadline-dev libsqlite3-dev wget curl llvm libncursesw5-dev \
  xz-utils tk-dev libxml2-dev libxmlsec1-dev libffi-dev liblzma-dev git

# 3. 配置 zsh
echo 'export PYENV_ROOT="/root/.pyenv"' >> ~/.zshrc
echo 'export PATH="$PYENV_ROOT/bin:$PYENV_ROOT/shims:$PATH"' >> ~/.zshrc
echo 'eval "$(pyenv init - zsh)"' >> ~/.zshrc
echo 'eval "$(pyenv virtualenv-init -)"' >> ~/.zshrc
source ~/.zshrc

# 4. 安装 Python
pyenv install 3.10.14

# 5. 设置全局版本
pyenv global 3.10.14

# 6. 创建虚拟环境
pyenv virtualenv 3.10.14 myenv

# 7. 项目目录绑定
cd /your/project
pyenv local myenv