素材阁

pyenv 速查

共 22 条 pyenv 版本管理用法,涵盖安装与切换、版本管理、作用域与优先级、虚拟环境、安装配置。 支持搜索与分类筛选,点击即可复制。

安装与切换

按目录切换 Python 版本。

命令说明
安装某个 Python 版本
列出已安装版本
设置全局默认版本
为当前目录设置版本(写 .python-version)
查看当前生效版本

版本管理

查询与清理。

命令说明
查看可安装版本
卸载版本
重建 shims(装了新工具后执行)
更新 pyenv 自身与版本列表(插件)
查看当前版本对应的程序路径

作用域与优先级

shell > local > global。

命令说明
仅当前 shell 会话生效
目录级版本(随项目提交)
取消 shell 级设置
临时用环境变量指定

虚拟环境

pyenv-virtualenv 插件。

命令说明
基于某版本创建虚拟环境
激活 / 退出
让目录自动激活该环境
列出全部虚拟环境

安装配置

shell 初始化与依赖。

命令说明
启用 pyenv(zsh)
启用自动激活
安装 pyenv
编译 Python 所需系统库

使用说明

pyenv 速查:安装与切换、版本管理、作用域与优先级、虚拟环境、安装配置;支持搜索与分类筛选,点击即可复制。

  1. 按用途点分类:安装与切换、版本管理、作用域与优先级、虚拟环境、安装配置。
  2. 点「命令」列复制到终端。
  3. pyenv local <版本> 会在目录写入 .python-version,进目录自动生效。
  4. 装了新工具或版本后执行 pyenv rehash 重建 shims。

常见问题

pyenv、virtualenv、venv 各管什么?
pyenv 管 Python 解释器版本;virtualenv/venv 管同一解释器下的隔离依赖环境。两者搭配用。
命令找不到怎么办?
确认 shell 初始化里已 eval "$(pyenv init -)",并在装了新工具后执行 pyenv rehash。
需要联网吗?
速查内容本地可用;安装 Python 版本需联网。

延伸阅读

相关工具