Windows 上用 pyenv-win 玩转多版本 Python：安装、国内源、常用命令与版本切换-CSDN博客

想在一台机器上优雅地共存多个 Python 版本？在 Windows 上，pyenv-win 是最轻量也最“懂开发者”的选择。本文带你用命令行完成安装、配置国内源/加速、掌握常用命令，顺手装好指定版本并实现一键切换。

一、安装 pyenv-win（命令行）

优先推荐 PowerShell 一键脚本；

PowerShell 一键安装（官方推荐）

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"

二、安装包安装

下载源码包：夸克网盘分享

解压到本地：

重开“终端管理员”

执行：

pyenv --version

提示：Windows 10/11 可能需要关闭内置 Python 别名（开始菜单 → “管理应用执行别名” → 关闭 Python 的 “App Installer” 别名）。

三、在国内如何“设置pyenv-win源”

配置 pyenv-win 国内镜像（长期有效）

右键我的电脑-属性，点开高级设置选项-设置环境变量-系统变量中添加新变量

变量名：PYTHON_BUILD_MIRROR_URL
变量值：https://mirrors.huaweicloud.com/python/

四、常用命令速查

发现与安装
- 查看可安装版本列表：

pyenv install -l

- 安装指定版本（可加 -q 静默）：

pyenv install 3.12.5
pyenv install 3.10.13 -q

- 安装多个版本：

pyenv install 3.8.10 3.9.13 3.10.13

版本切换（优先级：shell > local > global）
- 设置全局（所有目录默认）：

pyenv global 3.12.5

- 设置项目本地（在项目根目录写 .python-version）：

pyenv local 3.10.13

- 临时只在当前会话：

pyenv shell 3.9.13

查看与诊断

pyenv versions         # 已安装列表
pyenv version          # 当前生效版本及来源
pyenv which python     # 可执行文件实际路径
python -c "import sys; print(sys.executable)"

维护与清理

pyenv update           # 更新版本数据库（2.64.x/2.32.x）
pyenv rehash           # 版本/库变更后重建 shims
pyenv uninstall 3.9.13 # 卸载版本
pyenv install -c       # 清空下载缓存

更多命令见：主页与命令列表

五、安装“指定版本”的正确姿势

最新稳定的 3.12.x：

pyenv update
pyenv latest 3.12
pyenv install 3.12.5
pyenv global 3.12.5

安装老版本并只在当前项目使用：

pyenv install 3.8.10
cd D:\code\myproj
pyenv local 3.8.10

需要 32 位解释器（在 x64 机器上）：

pyenv install 3.8.10-win32
pyenv local 3.8.10-win32

六、在国内如何“设置pip源”

配置 pip 国内镜像（长期有效）
- 清华 TUNA

python -m pip install --upgrade pip
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

七、常见问题与排障

pyenv 命令找不到/版本不生效：重开终端；确认 PATH 中包含 ...\pyenv-win\bin 与 ...\pyenv-win\shims；VS Code 需重启。
运行 python 还是系统自带：在开始菜单关闭 Python 的应用执行别名；或检查 pyenv which python 指向是否为 ...\pyenv-win\versions\...。
切换版本后工具不可用：执行 pyenv rehash 以重建 shims。
下载慢或超时：优先配置系统代理；或使用“手动缓存安装包”的方式。
需要 32 位兼容：了解 32bit-train（版本号显示为 2.32.x）分支的安装与使用，见安装指南。

八、从 0 到 1 的极速上手脚本

# 1) 安装 pyenv-win
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"

# 2) 配置 pip 国内镜像（以 TUNA 为例）
python -m pip install --upgrade pip
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

# 3) 安装并切到指定版本
pyenv update
pyenv install 3.12.5 -q
pyenv global 3.12.5

# 4) 验证
pyenv version
python -c "import sys; print(sys.version, '->', sys.executable)"