pyenv
pyenv 是一个用纯 Shell 编写的 Python 版本管理工具,可在同一台机器上安装、切换多个 Python 版本,支持按项目设置版本,并兼容 CPython、PyPy、Jython 等多种发行版。
爱鲜报评分
0.0
0 人评分
45k
星数
否
中文
Shell
主语言
是
活跃
497
贡献者
人工分析
EDITORIAL推荐理由
pyenv 是 Python 开发者解决多版本共存问题的经典方案,GitHub 星标超过 4.5 万,社区成熟稳定。它不依赖 Python 自身、通过 shim 机制工作,对系统侵入性低。无论是维护老项目还是测试跨版本兼容性,都值得纳入开发环境。
适用场景
- 在同一台机器上并存多个 Python 版本并按项目切换
- 为老项目锁定特定 Python 版本,避免升级破坏依赖
- 使用 tox 等工具做跨 Python 版本兼容性测试
- 在 Linux/macOS 开发机上统一管理 Python 运行时
优点
- 纯 Shell 实现,不依赖 Python 自身,无引导问题
- shim 机制对系统侵入小,无需修改 shell 启动逻辑即可生效
- 支持 CPython、PyPy、Jython 等多种 Python 发行版
- 可按全局、项目目录、环境变量多层级覆盖版本
- MIT 协议,社区活跃、文档完善
缺点
- 官方不支持 Windows,需改用 pyenv-win 分支
- 安装新版本前需自行准备编译依赖,否则构建易失败
- 不负责虚拟环境管理,需配合 pyenv-virtualenv 或 venv
- 对新手而言 shell 初始化配置步骤略繁琐
上手难度
入门
pyenv:简洁的 Python 版本管理工具
pyenv 是一个用纯 Shell 脚本实现的 Python 版本管理工具,遵循 UNIX「单一职责」的传统,只专注做好一件事:让你在同一台机器上轻松安装和切换多个 Python 版本。
核心能力
- 全局版本切换:按用户维度设置默认 Python 版本
- 项目级版本:在项目目录中通过配置文件锁定 Python 版本
- 多发行版支持:CPython、PyPy、Stackless Python、Jython 等
- 环境变量覆盖:可用环境变量临时指定版本
- 多版本并存查找:同时从多个 Python 版本中搜索命令,便于跨版本测试
与其他方案的区别
与 pythonbrew、pythonz 等工具相比,pyenv 有几个鲜明特点:
- 不依赖 Python 本身:完全由 Shell 脚本构成,不存在「用 Python 管理 Python」的引导问题
- 无需加载进 shell:通过 shim 机制,只需把一个目录加入
PATH即可工作 - 不管理虚拟环境:虚拟环境可自行用
virtualenv创建,或借助pyenv-virtualenv插件自动化
工作原理简述
pyenv 会在 PATH 最前面插入一个 shim 目录,其中包含 python、pip 等命令的转发脚本。执行命令时,shim 根据当前目录与配置决定实际调用哪个 Python 版本。
# 查看当前使用的版本
pyenv version
# 列出可安装的版本
pyenv install --list
# 安装指定版本
pyenv install 3.12.0
# 设置全局版本
pyenv global 3.12.0
# 为当前项目设置版本
pyenv local 3.11.6
安装方式概览
- Linux/Unix:可使用官方安装脚本,或直接
git clone仓库到~/.pyenv - macOS:推荐使用 Homebrew 安装
- Windows:官方不支持,推荐使用社区维护的
pyenv-win分支
安装后还需按文档配置 shell 环境并准备 Python 编译依赖,之后即可开始使用。
适用人群
需要同时维护多个 Python 项目、做跨版本兼容性测试,或希望以低侵入方式管理 Python 运行时的开发者,都适合使用 pyenv。
评论
- 暂无评论,来写第一条吧。