Python
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