Windows下怎么将Python升级到指定版本

陆遥
陆遥
发布时间:2026-11-22 | 19人浏览过
原创

详细介绍在Windows操作系统中将Python升级到指定版本的完整方案,涵盖版本检查、安装包选择、环境变量Path配置、py启动器调度与依赖库迁移。

在Windows系统下,Python并不存在一条命令完成整机覆盖升级的原生机制。小修补版本可通过运行更新补丁包就地更新,而跨次要版本(例如从Python 3.9升级到指定版本3.11)的本质是安装目标指定版本的新解释器,再通过调整系统环境变量Path或使用Windows自带的Python启动器(py.exe)接管默认调用,最后迁移依赖包。

一、升级前的现状核对与依赖备份

在着手升级之前,需要先确认当前系统中已存在的Python版本,以及该环境下已安装的第三方扩展库。很多开发者在直接安装新版后,常因旧项目的第三方库丢失而导致代码无法正常运行。

打开Windows终端或PowerShell,执行以下命令查看当前默认的Python版本与具体可执行程序路径:

python --version
where python

如果命令行返回了当前版本号(例如 Python 3.8.10),说明当前已有版本被注册到了环境变量中。随后,建议将当前环境中积累的第三方库清单导出为文本文件,方便在新环境中快速还原:

pip freeze > requirements.txt

该命令会在当前目录下生成一个 requirements.txt 文件,记录了所有已安装库及其精准版本号。

Windows下怎么将Python升级到指定版本
图1:Python 升级类型判断与操作分支

二、下载并安装指定的 Python 版本

若需要升级至指定版本(例如 Python 3.11.8),切勿直接点击官网首页的最新版黄色下载按钮。正确的步骤是获取官方存档中的特定版本安装程序:

  1. 使用浏览器访问 Python 官方 Windows 发布存档页面:python.org/downloads/windows/。
  2. 在页面中找到目标版本(例如 Python 3.11.8),并在文件列表中找到 Windows installer (64-bit)。对于绝大多数现代 64 位 Windows 10/11 系统,必须选用 64 位安装包。
  3. 下载完成后双击运行 python-3.11.8-amd64.exe。
关键安装选项说明: 在安装向导的首个界面,务必注意底部两个复选框:
1. 勾选 "Add python.exe to PATH":这会自动将该目标版本的执行路径写入系统环境变量。
2. 勾选 "Use admin privileges when installing py.exe"(若有):安装并更新全局 Python 启动器。
Windows下怎么将Python升级到指定版本
图2:安装选项与物理文件系统隔离示意

三、切换与确认默认的 Python 版本

安装完成后,需要确保命令行在调用 python 时正确指向刚刚安装的目标版本。在 Windows 下有两种最标准的方式实现这一目标:

方法 1:利用官方 Python Launcher(推荐)

Windows 官方安装包随附的 py.exe 是解决多版本共存最优雅的工具。即便旧版本依然在系统中,也无需大动干戈修改注册表:

# 查看系统识别到的所有 Python 版本
py --list

# 运行特定版本的 Python 终端
py -3.11

# 使用指定版本的 pip 安装模块
py -3.11 -m pip install requests

在 py --list 的输出中,带有星号 * 的项目表示当前的默认调用版本。如果希望将 3.11 设为全局默认,可以通过系统环境变量新增名为 PY_PYTHON 的变量,将其值设定为 3.11。

方法 2:调整系统环境变量 Path

如果习惯在任何终端(CMD、PowerShell、Git Bash)直接敲击 python 命令,则需要通过调整 Path 的先后顺序完成指定版本的接管:

  1. 按下快捷键 Win + R,输入 sysdm.cpl 打开“系统属性”。
  2. 在“高级”选项卡下点击“环境变量”。
  3. 在“系统变量”或“用户变量”中找到 Path,选中并点击“编辑”。
  4. 检查列表中是否存在新旧两个 Python 版本的路径:
    C:\Users\用户名\AppData\Local\Programs\Python\Python311\
    C:\Users\用户名\AppData\Local\Programs\Python\Python311\Scripts\
  5. 使用右侧的“上移”按钮,将新版本(Python311)的两条路径移动到旧版本(如 Python38)的上方。
  6. 逐级点击“确定”保存所有修改。
Windows下怎么将Python升级到指定版本
图3:Windows Path 变量检索优先级原理

四、验证升级成果与恢复第三方依赖

修改完环境变量后,必须完全关闭当前的终端窗口并重新打开一个新的终端,否则旧终端仍会缓存之前的环境变量。

在新终端中执行验证:

python --version
pip --version

若输出明确显示为你指定的版本(例如 Python 3.11.8),且 pip 路径也指向 Python311\site-packages,说明升级和重定向已大功告成。

接下来,利用升级前备份的依赖清单还原常用第三方包:

python -m pip install --upgrade pip
pip install -r requirements.txt

如果在批量安装时某些特定的 C 扩展库(例如某些旧版本的数值计算库)编译报错,通常是因为该版本暂未向新版 Python 提供预编译 Wheel 文件。此时建议前往对应库的官网单独安装匹配新版本的最新发行版。

五、常见问题排查与避坑指南

  • 输入 python 依然显示旧版本: 除检查 Path 顺序外,Windows 10/11 用户还需检查“应用执行别名”。进入 Windows“设置 -> 应用 -> 高级应用设置 -> 应用执行别名”,将列表中的“应用安装程序 (python.exe)”与“应用安装程序 (python3.exe)”关闭,防止微软商店抢占命令入口。
  • pip 报错 Fatal error in launcher: 这通常发生在旧版 Python 被物理删除后,旧的 pip 启动入口残留所致。使用完整显式命令 python -m pip install ... 可以直接绕过可执行启动器,强制通过当前指定的 Python 解释器运行 pip。
  • 旧版本是否需要卸载: 如果旧版本不再需要,可以直接通过 Windows“设置 -> 安装的应用”将其卸载。如果项目代码仍需兼容旧版本测试,完全可以放心共存,只需使用 py -3.8 或 py -3.11 区分调用即可。
Windows下怎么将Python升级到指定版本
图4:Windows 下 Python 升级操作全流程与核心命令总结
相关专题:

本站声明

本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。

Python 相关产品和应用

全部下载

专题列表