Python使用pyenv实现多环境管理

脚本专栏发布日期：2025/11/1 浏览次数：1

正在浏览：Python使用pyenv实现多环境管理

1 背景&概述

因某些需求，需要安装 TensorFlow ，很自然地在终端敲下了以下命令：

pip install tensorflow

然后。。。

~~好家伙？？？~~

居然没有？？

因为是 Python 3.9 ，去 pypi 搜索了，居然还真没有支持的，最高只有 Python 3.8 ：

于是便考虑一个多版本的 Python 环境，碰巧就在 Github 上看到了一个 22.3k 的东西：

这就是 pyenv ，一个简单的 Python 版本管理器，可以轻松地在各个 Python 版本之间进行切换。

好了废话不说，进入正题。

安装有两种方式：

curl https://pyenv.run | bash
# 或
curl -L https://github.com/pyenv/pyenv-installer/raw/master/bin/pyenv-installer | bash

手动安装大致分为三步：

2.2.1 安装 pyenv

笔者系统 Manjaro ，可以直接 yay 安装：

yay -S pyenv

其他系统的可以使用 apt search / yum search 等看看软件包仓库有没有，有的话直接安装即可，没有的话，可以 clone 安装：

git clone https://github.com/pyenv/pyenv.git ~/.pyenv

（ 这一步是可选的 ）接着就是编译动态 bash 扩展进行加速：

cd ~/.pyenv && src/configure && make -C src

官方解释说，不用害怕编译失败，因为仍然会正常工作。

2.2.2 配置环境变量

这一步就是把 PYENV 以及更新后的 PATH 配置成环境变量，官方文档按照 shell 类型进行了分类，根据自己情况选择即可。

2.2.2.1 bash

echo 'export PYENV_ROOT="$HOME/.pyenv"'  ~/.bash_profile
echo 'export PATH="$PYENV_ROOT/bin:$PATH"'  ~/.bash_profile

2.2.2.2 Zsh

echo 'export PYENV_ROOT="$HOME/.pyenv"'  ~/.zshrc
echo 'export PATH="$PYENV_ROOT/bin:$PATH"'  ~/.zshrc

2.2.2.3 Fish shell

set -Ux PYENV_ROOT $HOME/.pyenv
set -Ux fish_user_paths $PYENV_ROOT/bin $fish_user_paths

2.2.3 初始化

配置完环境变量后还要进行初始化操作，文档同样按 shell 类型进行了分类。

2.2.3.1 bash

echo -e 'if command -v pyenv 1>/dev/null 2>&1; then\n eval "$(pyenv init -)"\nfi'  ~/.bash_profile

2.2.3.2 Zsh

echo -e 'if command -v pyenv 1>/dev/null 2>&1; then\n eval "$(pyenv init -)"\nfi'  ~/.zshrc

2.2.3.3 Fish shell

echo -e '\n\n# pyenv init\nif command -v pyenv 1>/dev/null 2>&1\n pyenv init - | source\nend'  ~/.config/fish/config.fish

重新开启一个终端，输入 pyenv ，输出如下信息就表明安装成功了：

pyenv commands：查看所有pyenv命令
pyenv exec：使用特定Python版本执行某条命令
pyenv global：设置或查看全局Python版本
pyenv hooks：列出给出的pyenv命令的钩子脚本
pyenv init：配置shell环境
pyenv install：安装某个版本的Python
pyenv local：为某个应用设置特定的Python版本
pyenv prefix：显示对应Python版本的路径前缀
pyenv rehash：再哈希pyenv shims（不清楚有什么用，欢迎评论补充）
pyenv root：显示pyenv根目录
pyenv shell：为某个shell设置特定的Python版本（与pyenv local类似）
pyenv shims：列出当前存在的shims（pyenv的工作原理就是在一个叫shims的目录下创建Python解释器的“假版本”，寻找Python应用时先从该目录查找）
pyenv uninstall：卸载某个版本Python
pyenv --version：显示pyenv版本
pyenv version：显示当前Python版本，等价于pyenv version-name+pyenv version-file
pyenv version-file/version-name/version-origin：当前Python版本对应的文件/名字/位置
pyenv whence：列出已安装的一个范围内的Python版本，比如列出本地安装的Python2到Python3的版本，可以使用pyenv whence 2to3
pyenv which：列出可执行文件的绝对路径，比如pyenv which python可以列出python命令的绝对路径