pyenv是专门用于管理多个Python版本的工具,它允许开发者在同一台设备上安装多个不同版本的Python,并且可以根据项目需求快速切换对应的版本,避免版本冲突带来的开发问题。不同操作系统的安装方式存在一定差异,下面分别介绍常见的安装方法。

安装前的依赖准备
在安装pyenv之前,需要先安装一些必要的系统依赖,否则可能导致pyenv安装失败或者后续Python版本编译出错。不同系统的依赖安装命令如下:
Ubuntu/Debian系统
# 更新软件源 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
CentOS/RHEL系统
# 安装编译依赖 sudo yum install -y gcc zlib-devel bzip2 bzip2-devel readline-devel sqlite sqlite-devel openssl-devel xz xz-devel libffi-devel
macOS系统
macOS系统需要先安装Xcode命令行工具,然后安装Homebrew包管理器,执行以下命令即可:
# 安装Xcode命令行工具 xcode-select --install # 安装Homebrew /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
不同系统安装pyenv的具体步骤
Linux系统自动安装
pyenv官方提供了自动安装脚本,在终端执行以下命令即可完成安装:
# 执行自动安装脚本 curl https://pyenv.run | bash
安装完成后,需要将pyenv的环境变量添加到shell配置文件中,如果你使用的是bash,编辑~/.bashrc文件,如果是zsh,编辑~/.zshrc文件,在文件末尾添加以下内容:
export PYENV_ROOT="$HOME/.pyenv" export PATH="$PYENV_ROOT/bin:$PATH" eval "$(pyenv init -)" eval "$(pyenv virtualenv-init -)"
添加完成后,执行以下命令让配置生效:
# bash用户执行 source ~/.bashrc # zsh用户执行 source ~/.zshrc
macOS系统安装
macOS系统可以通过Homebrew快速安装pyenv,执行以下命令:
brew update brew install pyenv
同样需要将环境变量添加到shell配置文件中,步骤和Linux系统一致,添加对应的配置后执行source命令让配置生效。
Windows系统安装
pyenv本身不支持原生的Windows系统,但是可以使用pyenv-win版本,通过PowerShell执行以下命令安装:
# 安装pyenv-win 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
安装完成后需要重启PowerShell,让环境变量生效。
安装验证
安装完成后,可以通过以下命令验证pyenv是否安装成功:
pyenv --version
如果终端输出pyenv的版本号,说明安装成功。之后可以通过以下命令查看可安装的Python版本:
pyenv install --list
如果需要安装指定版本的Python,比如安装Python 3.9.6,执行以下命令即可:
pyenv install 3.9.6
安装完成后可以通过pyenv versions命令查看已安装的所有Python版本,通过pyenv global 3.9.6命令设置全局使用的Python版本。