欢迎光临
我们一直在努力

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
赞(0)
未经允许不得转载:171主机测评 » Windows 上用 pyenv-win 玩转多版本 Python:安装、国内源、常用命令与版本切换
分享到: 更多 (0)

评论 抢沙发

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址