Windows 下使用 pyenv-win 管理多版本 Python:安装、配置与切换
介绍在 Windows 系统上使用 pyenv-win 工具管理多个 Python 版本的方法。内容包括通过 PowerShell 脚本或安装包进行安装,配置华为云镜像加速下载,设置 pip 国内源,以及掌握查看、安装、切换(全局/本地/临时)和卸载版本的常用命令。同时提供了常见问题排查指南和一键上手脚本,帮助开发者实现环境隔离与高效开发。

介绍在 Windows 系统上使用 pyenv-win 工具管理多个 Python 版本的方法。内容包括通过 PowerShell 脚本或安装包进行安装,配置华为云镜像加速下载,设置 pip 国内源,以及掌握查看、安装、切换(全局/本地/临时)和卸载版本的常用命令。同时提供了常见问题排查指南和一键上手脚本,帮助开发者实现环境隔离与高效开发。

想在一台机器上优雅地共存多个 Python 版本?在 Windows 上,pyenv-win 是最轻量也最'懂开发者'的选择。本文带你用命令行完成安装、配置国内源/加速、掌握常用命令,顺手装好指定版本并实现一键切换。
优先推荐 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' 别名)。
右键我的电脑 - 属性,点开高级设置选项 - 设置环境变量 - 系统变量中添加新变量。
变量名: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
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 # 清空下载缓存
更多命令见:主页与命令列表
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
pyenv install 3.8.10-win32
pyenv local 3.8.10-win32
python -m pip install --upgrade pip
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
...\pyenv-win\bin 与 ...\pyenv-win\shims;VS Code 需重启。pyenv which python 指向是否为 ...\pyenv-win\versions\...。pyenv rehash 以重建 shims。# 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)"
参考与延伸阅读:

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online
通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online