许多 Python 开发者都有这样的痛点： 项目 A 依赖 Python 3.8，项目 B 却要 Python 3.11，系统里装一个版本还好，多个版本就一团乱。

这时候——pyenv 就像“版本管理界的管家”，帮你轻松切换和管理不同 Python 环境。

一、什么是 pyenv？

pyenv 是一个用于管理多个 Python 版本的工具。 它能让你在一台电脑上安装多个 Python，并且：

• 按项目设置 Python 版本；
• 按用户设置全局默认版本；
• 临时切换不同版本进行测试。

换句话说，pyenv 让你不再被“系统自带 Python”绑架！

⚙️ 二、安装 pyenv（以 macOS 为例）

最简单的方法是使用 Homebrew：

brew update
brew install pyenv

安装完成后，在终端配置文件（如 ~/.zshrc）里加上：

# 配置 ~/.zshrc，解决切换版本不生效
export PATH="$HOME/.pyenv/bin:$PATH"
eval "$(pyenv init --path)"
eval "$(pyenv init -)"

然后重新加载配置：

source ~/.zshrc

三、安装不同版本的 Python

想装哪个版本，直接：

pyenv install 3.8.18
pyenv install 3.11.6

查看本地有哪些版本：

# 查看已经安装哪些版本
pyenv versions

pyenv versions 查看安装了哪些版本

切换版本也很简单：

# 设置全局版本
pyenv global 3.11.6     

# 在当前项目目录设置局部版本
pyenv local 3.8.18      

是不是比手动切换 PATH 方便太多了！

四、常见问题

安装慢？ pyenv 默认从 Python 官方镜像拉取包，可使用国内镜像源，例如清华大学镜像：

export PYTHON_BUILD_MIRROR_URL="https://mirrors.tuna.tsinghua.edu.cn/python/"

virtualenv、conda、pyenv 有什么区别？

• pyenv 管理 Python 解释器版本；
• virtualenv / venv 管理 虚拟环境依赖；
• conda 既能管版本，又能管依赖。

简单说：pyenv 管版本，virtualenv 管环境，两者可以搭配使用。

五、进阶玩法：pyenv + virtualenv

想要在不同 Python 版本下创建独立环境：

pyenv install 3.10.13
pyenv virtualenv 3.10.13 myenv310
pyenv activate myenv310

这样你就能在隔离环境中开发不同项目，互不干扰。

总结

写在最后

如果你常常：

• 切换多个 Python 项目；
• 使用旧项目但又想体验新语法；
• 在 Mac 或 Linux 下搞开发；

那 pyenv 绝对是你的“生产力神器”。 赶紧试试吧！

#Python入门# #开发工具# #程序员技巧# #pyenv# #效率提升#