python版本切换工具pyenv的安装及用法

目录

• Pyenv 是什么？
• 安装 Pyenv（macOS）
• 使用 Homebrew：
• 配置 shell（zsh 为例）
• 安装一个 Python 版本
• 在项目中设置 Python 版本（强烈推荐）
• 设置全局默认 Python 版本
• 搭配虚拟环境使用（最佳实践）
• 使用 venv
• 使用 Poetry（更现代）
• pyenv 常用命令总结
• Pyenv 的实现原理（简单讲）
• Pyenv + Poetry + pipx：最强组合

官网

python 的版本切换工具

python 的 Pyenv 相当于 node 的 nvm。

它可以让你：

• 安装多个 Python 版本
• 在项目中指定特定版本
• 自动切换版本，不影响系统环境
• 兼容 macOS / Linux

它不会替你管理虚拟环境，但可以与 venv / Poetry 完美结合。

brew update
brew install pyenv

编辑 ~/.zshrc，加入：

export PYENV_ROOT="$HOME/.pyenv"
export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init -)"

重新加载配置：

source ~/.zshrc

完成 🎉

比如安装当前最稳定的 Python 3.11：

pyenv install 3.11.7

查看已安装版本：

pyenv versions

进入项目目录：

cd my-ai-project
pyenv local 3.11.7

这会自动生成：

.python-version

以后进入这个目录时，会自动切换到 3.11.7，这就像 Node 中的：

.nvmrc

pyenv global 3.11.7

一般不推荐，除非你已经使用 pyenv 接管全部 Python。

python3 -m venv .venv
source .venv/bin/activate

poetry init
poetry install

Poetry 会自动读取 pyenv 的 Python 版本。

命令	作用
pyenv install -l	查看可安装的 Python 版本
pyenv install 3.11.7	安装指定版本
pyenv versions	查看已安装版本
pyenv local 3.11.7	设置项目 Python 版本
pyenv global 3.11.7	设置全局 Python 版本
pyenv uninstall 3.11.7	卸载版本
pyenv which python	查看当前可用 Python 路径

Pyenv 使用了一个非常巧妙的机制：

Shims（垫片）机制

它在你的 PATH 前面放置一个目录：

~/.pyenv/shims

里面放置 python, pip 等可执行文件的“代理”，

当你调用 python 时：

1. 先查 .python-version
2. 找出对应 Python 版本
3. 调用真实 Python 而不是系统 Python

这和 nvm 的原理几乎一样。

你可以这样搭配：

工具	作用
pyenv	管理 Python 版本（像 nvm）
poetry	管理项目依赖 & 虚拟环境（像 pnpm + package.json）
pipx	管理全局 CLI 工具安装（像 npm global install 的替代）

这套组合可打造行业内最干净、可维护的 AI/后端开发环境。

到此这篇关于python版本切换工具pyenv的安装及用法的文章就介绍到这了,更多相关python版本切换工具pyenv内容请搜索风君子博客以前的文章或继续浏览下面的相关文章希望大家以后多多支持风君子博客！

您可能感兴趣的文章:

• pyenv命令管理多个Python版本
• 详解使用 pyenv 管理多个版本 python 环境
• python版本管理之pyenv使用超详细指南
• 一文读懂Python版本管理工具Pyenv使用
• pyenv虚拟环境管理python多版本和软件库的方法
• python pyenv多版本管理工具的使用
• pyenv管理多个版本python的完整指南