在开发 Python 项目时，不同项目可能依赖不同版本的 Python，比如一个老项目需要 Python 3.8，而新项目想尝试 Python 3.12。直接使用系统默认的 Python 版本很容易造成冲突。这时，pyenv 就是一个非常实用的工具，它能让你在同一台机器上轻松管理多个 Python 版本，并按需切换。
什么是 pyenv？pyenv 是一个 Python 版本管理工具，它通过修改环境变量，在用户层面切换不同版本的 Python，不需要动系统自带的 Python。它的优点包括：
- 支持安装多个 Python 版本
- 可为每个项目设置独立的 Python 版本
- 不依赖虚拟环境，但可与 venv、pipenv、poetry 等配合使用
- 轻量、简单、跨平台（macOS/Linux）
推荐使用 pyenv-installer 脚本来安装，简单方便：
curl https://pyenv.run | bash
这个脚本会自动安装 pyenv 及其常用插件（如 pyenv-virtualenv）。安装完成后，需要将 pyenv 加入 shell 配置文件中。根据你使用的 shell（bash/zsh），编辑对应文件：
- 如果是 zsh（macOS 默认）：编辑 ~/.zshrc
- 如果是 bash：编辑 ~/.bashrc
添加以下内容：
export PYENV_ROOT="$HOME/.pyenv" export PATH="$PYENV_ROOT/bin:$PATH" eval "$(pyenv init -)"
保存后运行：
source ~/.zshrc
然后输入 pyenv，如果看到帮助信息，说明安装成功。
使用 pyenv 安装和切换 Python 版本查看可安装的 Python 版本：
pyenv install --list
安装你需要的版本，例如：
Teleporthq
一体化AI网站生成器，能够快速设计和部署静态网站
182
查看详情
pyenv install 3.9.18 pyenv install 3.11.6 pyenv install 3.12.0
安装完成后，查看已安装的版本：
pyenv versions
你会看到类似输出：
* system (set by /home/user/.pyenv/version) 3.9.18 3.11.6 3.12.0
设置全局默认版本：
pyenv global 3.11.6
或者为某个项目单独设置版本。进入项目目录：
cd my-old-project pyenv local 3.9.18
这样，进入这个目录时会自动使用 Python 3.9.18，退出则恢复全局设置。
结合虚拟环境更高效pyenv 管理的是 Python 解释器版本，而项目依赖建议用虚拟环境隔离。你可以配合 python -m venv 使用：
pyenv local 3.11.6 python -m venv venv source venv/bin/activate
这样既固定了 Python 版本，又隔离了依赖包，避免污染全局环境。
基本上就这些。pyenv 不复杂，但解决了多版本共存的大问题。只要花十分钟配置好，以后换项目再也不用担心版本不兼容。
以上就是使用 pyenv 搭建灵活的 Python 环境的详细内容，更多请关注知识资源分享宝库其它相关文章！
相关标签： linux python 工具 mac curl macos 环境变量 配置文件 cos Python bash virtualenv macos linux 大家都在看： 解决Linux系统下用户安装程序（如Pipenv）不在PATH环境变量的问题 在 Linux 系统中如何解决 DataCap 验证码无法显示的问题？ Linux 定时任务实战：Python 脚本自动化执行配置 机器学习模型部署：TensorFlow Serving 在 Linux 的配置 Linux 下 Python 调试技巧：pdb 与 VS Code 集成实战
发表评论:
◎欢迎参与讨论，请在这里发表您的看法、交流您的观点。