Windows 上用 pyenv-win 玩转多版本 Python：安装、国内源、常用命令与版本切换
想在一台机器上优雅地共存多个 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)"结语
- 对开发者：pyenv-win 让“一个项目一个 Python”的原则落地，切换无痛、升级安全。
- 对初学者：用全局/本地版本区隔学习路线，既能追新，也不怕旧项目挂掉。
参考与延伸阅读：
- 官方主页与命令列表：pyenv for Windows | pyenv-win
- 官方安装文档：Installation | pyenv-win
