pyenv是一个Python版本管理工具，能在用户级别轻松切换不同Python版本，避免项目间版本冲突。它通过安装独立的Python版本并支持全局、项目或临时会话级切换，实现灵活开发环境配置。安装需先满足系统依赖，再通过脚本获取pyenv并配置环境变量，随后可用pyenv install安装指定版本，pyenv versions查看已安装版本，pyenv global设置全局版本，pyenv local为项目设定专用版本，结合pyenv-virtualenv还可创建隔离环境，提升开发效率。
在开发不同项目时，经常会遇到需要使用不同版本的Python的情况。比如有的项目依赖Python 3.8，而另一个项目必须用Python 3.11。手动切换和管理这些版本非常麻烦。pyenv 就是为了解决这个问题而生的工具——它能让你轻松地在多个Python版本之间切换，且无需影响系统默认的Python环境。
什么是pyenv？
pyenv 是一个简单的 Python 版本管理工具，支持在用户级别安装和切换多个 Python 版本。它不会修改系统 Python，所有操作都在用户目录下完成，安全且灵活。你可以通过 pyenv 快速安装、卸载、切换全局或项目级别的 Python 版本。
安装pyenv
在开始使用之前，先安装 pyenv。以下是在类Unix系统（如macOS、Linux）上的安装方法：
1. 安装依赖库
立即学习“Python免费学习笔记（深入）”；
确保系统已安装编译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 libncurses5-dev libncursesw5-dev xz-utils tk-dev libffi-dev liblzma-dev python-openssl git - CentOS/RHEL:
sudo yum groupinstall "Development Tools" && sudo yum install openssl-devel bzip2-devel libffi-devel zlib-devel - macOS: 安装 Xcode 命令行工具：
xcode-select --install
2. 使用git克隆pyenv仓库
推荐使用自动安装方式：
curl https://pyenv.run | bash
这条命令会自动安装 pyenv 及其常用插件（如 pyenv-virtualenv）。
3. 配置环境变量
将 pyenv 添加到 shell 配置文件中。根据你使用的 shell 类型（bash、zsh等），编辑对应的配置文件：
- 如果是 zsh（macOS默认）：编辑
~/.zshrc - 如果是 bash：编辑
~/.bashrc或~/.bash_profile
添加以下内容：
export PYENV_ROOT="$HOME/.pyenv" export PATH="$PYENV_ROOT/bin:$PATH" eval "$(pyenv init -)"
保存后执行：source ~/.zshrc 或 source ~/.bashrc 使配置生效。
4. 验证安装
运行以下命令检查是否安装成功：
pyenv --version
如果输出版本号（如 pyenv 2.3.2），说明安装成功。
使用pyenv管理Python版本
安装完成后，就可以开始使用 pyenv 来管理 Python 版本了。
1. 查看可安装的Python版本
pyenv install --list
这个命令会列出所有可以安装的 Python 版本，包括 CPython、PyPy 等。你可以搜索关键词，例如：
pyenv install --list | grep "3.11"
2. 安装指定版本的Python
例如安装 Python 3.11.6：
pyenv install 3.11.6
安装过程可能需要几分钟，取决于网络和系统性能。如果你希望使用系统已有的Python构建，也可以使用 pyenv install --skip-existing 跳过已安装版本。
3. 查看已安装的Python版本
pyenv versions
该命令会列出当前所有可用的Python版本，带星号的是当前正在使用的版本。
4. 设置全局Python版本
设置整个系统的默认Python版本（对所有项目生效）：
pyenv global 3.11.6
之后运行 python --version 就会显示你设定的版本。
5. 设置项目级Python版本
进入某个项目目录，设置该目录专用的Python版本：
cd /path/to/your/projectpyenv local 3.8.10
这样在这个项目目录下，会自动使用 Python 3.8.10，退出目录则恢复全局设置。pyenv 会在目录中生成一个 .python-version 文件记录版本信息。
6. 临时切换Python版本
使用 pyenv shell 可以临时设置当前终端会话的Python版本：
pyenv shell 3.9.18
关闭终端后设置失效。
常见问题与技巧
安装失败？检查编译依赖
如果 pyenv install 报错（如缺少 ssl 模块），通常是系统缺少开发库。请确认前面提到的依赖包已完整安装。
pip 安装的包去哪儿了？
每个 Python 版本有独立的 site-packages 目录，互不干扰。你在哪个版本下运行 pip，包就安装到哪个环境中。
结合 virtualenv 使用更高效
虽然 pyenv 管理 Python 解释器版本，但建议搭配虚拟环境使用。pyenv 自带插件 pyenv-virtualenv 可以创建隔离环境：
pyenv virtualenv 3.11.6 myproject-envpyenv activate myproject-env
基本上就这些。pyenv 让多版本 Python 管理变得简单直观，特别适合开发者维护多个项目。只要记住几个核心命令：install、versions、global、local，就能应对大多数场景。不复杂但容易忽略的是环境变量配置和依赖安装，这一步务必认真完成。
