在Python开发过程中，不同项目对Python版本的要求往往存在差异，手动管理多个Python版本容易出现路径冲突、依赖不兼容等问题。pyenv作为一款专门用于Python版本管理的工具，能够很好地解决这些痛点，让版本切换变得简单高效。
pyenv的核心作用
pyenv的主要功能包括多版本Python的安装、全局版本切换、项目级版本指定，以及和虚拟环境工具的配合使用。它不会修改系统自带的Python环境，所有安装的版本都存放在用户目录下，安全性更高。
核心优势
- 无需管理员权限即可安装多个Python版本
- 支持全局、本地、临时三种版本作用范围
- 兼容主流操作系统，安装配置简单
- 可以和virtualenv、poetry等工具无缝配合
pyenv的安装步骤
Linux/macOS系统安装
首先安装pyenv的依赖环境，以Ubuntu为例，执行以下命令安装依赖：
sudo apt update sudo 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
然后使用官方安装脚本安装pyenv：
curl https://pyenv.run | bash
安装完成后，需要将pyenv的配置添加到shell配置文件中，比如~/.bashrc或者~/.zshrc：
export PYENV_ROOT="$HOME/.pyenv" export PATH="$PYENV_ROOT/bin:$PATH" eval "$(pyenv init -)" eval "$(pyenv virtualenv-init -)"
执行source ~/.bashrc让配置生效，之后输入pyenv --version验证安装是否成功。
Windows系统安装
Windows系统可以使用pyenv-win版本，通过PowerShell执行以下命令安装：
Invoke-WebRequest -UseBasicParsing -Uri "https://raw.githubusercontent.com/pyenv-win/pyenv-win/master/pyenv-win/install-pyenv-win.ps1" -OutFile "./install-pyenv-win.ps1" ./install-pyenv-win.ps1
安装完成后重启终端，输入pyenv --version验证即可。
pyenv常用命令实践
查看可安装的Python版本
执行以下命令可以列出所有可安装的Python版本：
pyenv install --list
如果只需要查看稳定的Python版本，可以过滤结果：
pyenv install --list | grep -E "^s+3.[0-9]+.[0-9]+$"
安装指定Python版本
比如安装Python3.8.10和Python3.11.4两个版本：
pyenv install 3.8.10 pyenv install 3.11.4
安装完成后可以通过以下命令查看已安装的所有版本：
pyenv versions
输出结果中带星号的表示当前正在使用的版本。
切换Python版本
pyenv支持三种版本作用范围：
| 作用范围 | 命令示例 | 说明 |
|---|---|---|
| 全局版本 | pyenv global 3.11.4 | 所有终端默认使用的Python版本 |
| 本地版本 | pyenv local 3.8.10 | 当前目录及子目录使用的Python版本，会生成.python-version文件 |
| 临时版本 | pyenv shell 3.8.10 | 当前终端会话临时使用的版本，关闭终端后失效 |
配合virtualenv使用
pyenv内置了virtualenv插件，可以直接创建基于指定Python版本的虚拟环境：
# 基于Python3.8.10创建名为my_project_env的虚拟环境 pyenv virtualenv 3.8.10 my_project_env # 激活虚拟环境 pyenv activate my_project_env # 退出虚拟环境 pyenv deactivate # 删除虚拟环境 pyenv uninstall my_project_env
实际开发场景示例
假设我们有两个项目，一个是老项目需要Python3.8，一个是新项目需要Python3.11，操作流程如下：
- 首先安装两个Python版本：
pyenv install 3.8.10和pyenv install 3.11.4 - 进入老项目目录，执行
pyenv local 3.8.10，此时该目录下默认使用Python3.8 - 进入新项目目录，执行
pyenv local 3.11.4，该目录下默认使用Python3.11 - 两个项目分别创建对应的虚拟环境，安装各自的依赖，完全不会互相干扰
常见问题解决
如果遇到安装Python版本失败的情况，首先检查是否安装了所有依赖库，其次可以尝试设置国内镜像源加速下载：
export PYTHON_BUILD_MIRROR_URL="https://npm.taobao.org/mirrors/python/"
之后再执行安装命令即可。如果需要卸载pyenv，直接删除~/.pyenv目录，并且删除shell配置文件中添加的pyenv相关配置即可。
pyenvPython版本管理virtualenvPython多环境开发环境配置修改时间：2026-07-18 20:30:28