使用pyenv管理多个Python版本：安装、切换、卸载的实战指南

脚本专家

在实际开发中，不同项目可能依赖不同版本的Python，手动管理环境既麻烦又容易出错。pyenv 正是解决这一痛点的利器——它允许你在同一台机器上安装、切换和隔离多个Python版本，且无需sudo权限。本文基于pyenv的常用命令，详细介绍从查看版本、安装、切换、卸载的完整操作流程。

2. # 查看已安装的版本列表，当前激活的版本前会显示 * 号
3. $ pyenv versions
4.   system
5.   2.7.16
6.   3.7.0
7. * 3.8.0 (set by PYENV_VERSION environment variable)

复制代码

上述输出表明系统自带Python以及通过pyenv安装的2.7.16、3.7.0、3.8.0，当前shell使用的版本是3.8.0（通过环境变量指定）。

2. # 列出所有可安装的Python版本
3. $ pyenv install -l
4.   2.1.3
5.   2.2.3
6.   ...
7.   3.7.5rc1
8.   3.8.0
9.   3.8-dev
10.   3.9-dev
11.   activepython-2.7.14
12.   activepython-3.5.4
13.   activepython-3.6.0
14.   ...

复制代码

列表很长，包含CPython、Anaconda、ActivePython等发行版，选择你需要的版本号即可。

2. # 安装指定版本的Python，例如3.6.6
3. $ pyenv install 3.6.6

复制代码

安装成功后会有类似输出：

2. $ pyenv install 2.7.16
3. python-build: use openssl from homebrew
4. python-build: use readline from homebrew
5. Installing Python-2.7.16...
6. python-build: use readline from homebrew
7. python-build: use zlib from xcode sdk
8. Installed Python-2.7.16 to /Users/houxin/.pyenv/versions/2.7.16

复制代码

如果下载很慢，可先用第三方下载工具（如迅雷）将源码包下载到本地，然后通过pyenv的离线安装机制完成安装（具体步骤可参考相关教程）。

安装完成后，pyenv提供了三种粒度来切换Python版本，优先级从高到低依次为：shell > local > global。

2. # 全局设置：所有shell默认使用该版本，版本号写入 ~/.pyenv/version
3. $ pyenv global 3.8.0
5. # 本地设置：仅当前目录及其子目录使用该版本，版本号写入 .python-version 文件
6. $ pyenv local 3.6.6
8. # Shell设置：仅当前终端会话生效，通过设置 PYENV_VERSION 环境变量
9. $ pyenv shell 3.7.0
10. # 取消shell版本设定
11. $ pyenv shell --unset

复制代码

例如，进入项目目录后执行 `pyenv local 3.6.6`，该目录下的python命令就会自动映射到3.6.6。

2. # 查看当前激活的Python版本及来源信息
3. $ pyenv version
4. 3.6.6 (set by /path/to/project/.python-version)

复制代码

2. # 卸载不再需要的Python版本
3. $ pyenv uninstall 3.5.2

复制代码

卸载后会从 `~/.pyenv/versions/` 目录下移除对应的版本文件夹。

总结：pyenv通过 `versions`、`install`、`global`/`local`/`shell`、`uninstall` 等简洁命令，完美解决了多版本Python的共存与切换问题。无论你是需要在不同项目间快速切换，还是测试新版Python的兼容性，pyenv都是不可或缺的工具。掌握这些基础操作，就能高效管理你的Python开发环境。

热心网友1

感谢楼主的详细教程！之前一直手动管理 Python 版本，换项目时经常遇到依赖冲突，看完这篇立马装了 pyenv。特别是三种切换粒度的对比很清晰，shell / local / global 的优先级顺序解决了我之前混淆的问题。另外提一下，如果遇到 `pyenv install` 下载慢，可以试试设置 `export PYTHON_BUILD_MIRROR_URL=镜像地址`，能快很多。期待楼主后续介绍虚拟环境插件 pyenv-virtualenv 的配合使用！