Windows下怎么将Python升级到指定版本
详细介绍在Windows操作系统中将Python升级到指定版本的完整方案,涵盖版本检查、安装包选择、环境变量Path配置、py启动器调度与依赖库迁移。
一、升级前的现状核对与依赖备份
在着手升级之前,需要先确认当前系统中已存在的Python版本,以及该环境下已安装的第三方扩展库。很多开发者在直接安装新版后,常因旧项目的第三方库丢失而导致代码无法正常运行。
打开Windows终端或PowerShell,执行以下命令查看当前默认的Python版本与具体可执行程序路径:
python --version
where python
如果命令行返回了当前版本号(例如 Python 3.8.10),说明当前已有版本被注册到了环境变量中。随后,建议将当前环境中积累的第三方库清单导出为文本文件,方便在新环境中快速还原:
pip freeze > requirements.txt
该命令会在当前目录下生成一个 requirements.txt 文件,记录了所有已安装库及其精准版本号。
二、下载并安装指定的 Python 版本
若需要升级至指定版本(例如 Python 3.11.8),切勿直接点击官网首页的最新版黄色下载按钮。正确的步骤是获取官方存档中的特定版本安装程序:
- 使用浏览器访问 Python 官方 Windows 发布存档页面:
python.org/downloads/windows/。 - 在页面中找到目标版本(例如
Python 3.11.8),并在文件列表中找到 Windows installer (64-bit)。对于绝大多数现代 64 位 Windows 10/11 系统,必须选用 64 位安装包。 - 下载完成后双击运行
python-3.11.8-amd64.exe。
1. 勾选 "Add python.exe to PATH":这会自动将该目标版本的执行路径写入系统环境变量。
2. 勾选 "Use admin privileges when installing py.exe"(若有):安装并更新全局 Python 启动器。
三、切换与确认默认的 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 的先后顺序完成指定版本的接管:
- 按下快捷键
Win + R,输入sysdm.cpl打开“系统属性”。 - 在“高级”选项卡下点击“环境变量”。
- 在“系统变量”或“用户变量”中找到
Path,选中并点击“编辑”。 -
检查列表中是否存在新旧两个 Python 版本的路径:
C:\Users\用户名\AppData\Local\Programs\Python\Python311\ C:\Users\用户名\AppData\Local\Programs\Python\Python311\Scripts\ - 使用右侧的“上移”按钮,将新版本(Python311)的两条路径移动到旧版本(如 Python38)的上方。
- 逐级点击“确定”保存所有修改。
四、验证升级成果与恢复第三方依赖
修改完环境变量后,必须完全关闭当前的终端窗口并重新打开一个新的终端,否则旧终端仍会缓存之前的环境变量。
在新终端中执行验证:
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区分调用即可。
免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。









