Windows 系统 Python 版本管理工具 pyenv-win 使用指南

安装 pyenv-win

1. 从 GitHub 仓库下载源码（点击 Code → Download ZIP） 下载地址：https://github.com/pyenv-win/pyenv-win
2. 解压文件，将文件夹重命名为 pyenv（记住你的地址，例如 D:\ProgramFiles\pyenv）
3. 配置环境变量：
   • 新增系统变量 PYENV，值为 pyenv 的地址 D:\ProgramFiles\pyenv\pyenv-win
   • 在系统变量 Path 中添加 %PYENV%\bin 和 %PYENV%\shims

验证安装： cmd 终端执行 pyenv，出现如下界面说明我们已经安装成功。

基本使用命令

1. 查看可安装的 Python 版本

pyenv install --list # 列出所有可安装版本（较多，可过滤查看）
pyenv install --list | findstr "3.12" # 过滤查看 3.12.x 版本

2. 安装指定 Python 版本

pyenv install 3.12.8 # 安装 3.12.8 版本（版本号需精确匹配列表中的名称）

3. 查看已安装的 Python 版本

pyenv versions # 列出所有已安装版本（* 表示当前活跃版本）

4. 切换 Python 版本

pyenv global 3.11.4 # 设置全局默认版本（所有终端生效）
pyenv local 3.9.13 # 设置当前目录局部版本（仅当前项目生效，会生成 .python-version 文件）
pyenv shell 3.8.10 # 设置当前终端会话临时版本（仅当前终端生效）

5. 卸载 Python 版本

pyenv uninstall 3.7.9 

6. 常用命令参考

commands             列出所有可用的 pyenv 命令
duplicate            创建一个重复的 python 环境
local                设置或显示特定于本地应用程序的 Python 版本
global               设置或显示全局 Python 版本
shell                设置或显示特定于 shell 的 Python 版本
install              Python 构建安装 Python 版本
uninstall            卸载特定的 Python 版本
update               更新缓存的版本数据库
rehash               重新安装 pyenv 垫片（安装可执行文件后运行此操作）
vname                显示当前的 Python 版本
version              显示当前 Python 版本及其来源
version-name         显示当前的 Python 版本
versions             列出 pyenv 可用的所有 Python 版本
exec                 通过首先准备路径来运行可执行文件，以便选定的 Python
which                显示可执行文件的完整路径（pycharm 解释器会用到）
whence               列出包含给定可执行文件的所有 Python 版本