Windows 11 安装 pyenv-win 管理不同版本 Python

2. 安装指定 Python 版本

# 1. 查看所有可安装的 Python 版本（含 2.x/3.x，筛选关键词可用 findstr）
pyenv install --list
# 列出全部
pyenv install --list | findstr "3.10"
# 只看 3.10 系列

# 2. 安装指定版本（如 3.10.11，安装过程可能需要几秒到几分钟）
pyenv install 3.10.11

# 3. 验证已安装的版本
pyenv versions
# 输出带 * 的是当前全局版本，如：
# * 3.10.11 (set by C:\Users\你的用户名\.pyenv\pyenv-win\version)
# 3.9.18

3. 切换 Python 版本（核心）

pyenv-win 支持全局版本（系统默认）、局部版本（当前目录生效）、临时版本（当前终端生效）。

# 1. 设置全局版本（系统默认，重启终端仍生效）
pyenv global 3.10.11

# 2. 设置局部版本（当前目录生效，会生成 .python-version 文件，进入该目录自动切换）
pyenv local 3.9.18
# 比如项目目录下执行，仅该目录用 3.9.18

# 3. 设置临时版本（仅当前终端生效，关闭终端失效）
pyenv shell 3.8.19

# 4. 验证当前版本
python --version
# 输出对应版本，如 Python 3.10.11

4. 卸载 Python 版本

# 卸载指定版本（如 3.9.18）
pyenv uninstall 3.9.18
# 确认卸载：执行 pyenv versions 查看，已无该版本则成功

5. 其他实用命令

# 刷新 shims（版本切换后若生效异常，执行此命令）
pyenv rehash
# 查看当前版本的生效路径
pyenv which python
# 输出如：C:\Users\你的用户名\.pyenv\pyenv-win\versions\3.10.11\python.exe

三、常见问题与解决

1. 安装失败 / 命令找不到：

   • 确认环境变量配置正确（%PYENV%\bin 和 %PYENV%\shims 在 Path 中）；
   • 重启终端 / 电脑，确保环境变量生效；
   • Chocolatey 安装后若提示「权限不足」，以管理员身份重新打开终端。

2. 安装 Python 版本时卡住 / 报错：

   • 检查网络，pyenv-win 会从 Python 官网下载安装包，网络差可能失败；
   • 手动下载对应版本的安装包（如 https://www.python.org/ftp/python/3.10.11/python-3.10.11-amd64.exe），放到 %PYENV%\cache 目录，再执行 pyenv install 3.10.11（跳过下载，直接安装）。

3. 切换版本后 python --version 仍显示系统版本：

   • 执行 pyenv rehash 刷新 shims；
   • 检查系统 Path 中是否有其他 Python 路径（如 C:\PythonXX），将 %PYENV%\shims 移到 Path 最顶部；
   • 关闭所有终端，重新打开后验证。

四、使用建议

1. 全局版本建议设为常用稳定版（如 3.10），项目目录用 pyenv local 设专属版本；
2. 切换版本后，若 pip 版本不匹配，执行 pip --version 验证（pyenv-win 会自动关联对应版本的 pip）；
3. 避免同时安装 Anaconda 和 pyenv-win 时修改 PATH 优先级，优先保留 pyenv-win 的 shims 路径。