Windows 系统的 Python 版本管理工具 - pyenv-win

pyenv-win 是一个用于 Windows 系统的 Python 版本管理工具，它可以帮助你在同一台电脑上安装、管理和切换多个 Python 版本，非常适合需要在不同项目中使用不同 Python 版本的开发场景。

一、安装 pyenv-win

方法 1：使用 PowerShell 自动安装（推荐）

1. 以管理员身份打开 PowerShell（确保已启用执行脚本权限）
2. 运行以下命令（自动克隆仓库并配置环境变量）：

   Invoke-WebRequest -UseBasicParsing -Uri "https://raw.githubusercontent.com/pyenv-win/pyenv-win/master/pyenv-win/install-pyenv-win.ps1" -OutFile "./install-pyenv-win.ps1"; &"./install-pyenv-win.ps1"
   

3. 安装完成后，关闭并重新打开终端使配置生效

方法 2：手动安装（适用于网络受限环境）

1. 从 pyenv-win 仓库 下载源码（点击 Code → Download ZIP）
2. 解压文件，将文件夹重命名为 pyenv-win
3. 将文件夹移动到合适位置（推荐 C:\Users\<你的用户名>\.pyenv\pyenv-win）
4. 手动配置环境变量：
   • 新增系统变量 PYENV，值为 C:\Users\<你的用户名>\.pyenv\pyenv-win
   • 在系统变量 Path 中添加 %PYENV%\bin 和 %PYENV%\shims

环境变量设置

验证安装

打开新终端，运行以下命令，若显示版本号则安装成功：

pyenv --version

二、基本使用命令

1. 查看可安装的 Python 版本

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

2. 安装指定 Python 版本

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

注意：

• 安装过程可能需要联网下载 Python 安装包
• 若安装失败，可能需要安装 Visual C++ 构建工具

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. 验证当前 Python 版本

python --version  # 查看当前生效的 Python 版本

三、注意事项

1. 安装新版本后，建议运行 pyenv rehash 更新 shims（确保命令关联正确）
2. 局部版本（local）优先级高于全局版本（global）
3. 若切换版本后不生效，检查环境变量是否正确配置，或重启终端
4. 部分老旧 Python 版本可能不支持最新 Windows 系统，建议优先选择较新的稳定版本

通过 pyenv-win，你可以轻松在不同 Python 版本间切换，避免因版本差异导致的项目兼容性问题，是 Python 开发者的实用工具。