Skip to main content

Pyenv

Pyenv 是一个 Python 版本管理工具,允许你在同一系统上轻松安装和切换多个 Python 版本。

特性

  • 📦 管理多个 Python 版本
  • 🔄 快速切换 Python 版本
  • 🎯 为项目设置特定版本
  • 🌐 支持虚拟环境
  • 🪟 跨平台支持(Windows/Linux/Mac)

安装

Windows

使用 pyenv-win:
添加环境变量:

Linux/Mac

配置 Shell(添加到 ~/.bashrc 或 ~/.zshrc):

基本使用

查看可安装的版本

安装 Python 版本

查看已安装版本

切换 Python 版本

卸载版本

高级用法

为项目设置版本

虚拟环境

结合 pyenv-virtualenv 使用:

查看版本来源

刷新 shims

配置文件

全局配置

项目配置

Shell 配置

常见问题

安装失败

Linux 依赖缺失:

版本切换不生效

Windows 路径问题

确保环境变量配置正确,并重启终端。

与其他工具对比

最佳实践

  1. 为每个项目设置 local 版本:避免全局版本冲突
  2. 使用虚拟环境:结合 pyenv-virtualenv
  3. 提交 .python-version:团队协作时统一版本
  4. 定期更新 pyenv:获取新版本支持
  5. 记录依赖:使用 requirements.txt 或 Pipfile

实用命令总结

参考资源

最后修改于 2026年4月19日