Windows系统怎么升级Python版本

在 Windows 系统中，升级 Python 并不是简单的在原有可执行文件上“原地在线覆盖”，而是通过下载并安装新版本的完整安装程序，随后由系统环境变量或 Python 官方启动器（py.exe）接管运行。Windows 平台支持不同版本的 Python 并行安装，因此标准升级路径通常包含四个核心阶段：导出旧环境依赖包清单、安装并配置新版 Python、切换系统执行入口、在新版本中恢复或重建运行环境。按照规范流程处理，既能顺畅用上新版本特性，又能避免旧项目依赖环境损坏。

一、升级前的准备工作：环境记录与依赖备份

在安装新版本之前，需要确认当前系统中安装的 Python 版本号、物理安装路径以及全局已安装的第三方扩展库。这不仅能明确当前版本状态，还能防止升级后出现找不到常用包的情况。

1. 检查当前版本与安装位置

按 Win + R 键输入 cmd 打开命令提示符，执行以下命令查看当前生效的 Python 版本：

python --version

示例输出：

Python 3.10.8

接着查看当前 python.exe 的具体所在路径，确认它是由官方安装器安装、通过 Microsoft Store 安装还是嵌入在其他开发套件中：

where python

示例输出：

C:\Users\Username\AppData\Local\Programs\Python\Python310\python.exe

2. 导出已安装的依赖库清单

由于跨次版本升级（例如从 Python 3.10 升级到 Python 3.12）会使用独立的 site-packages 目录，原有版本的第三方库不会自动复制到新版本中。执行以下命令，将当前全局环境中的包名与版本导出为一个文本文件：

pip freeze > requirements.txt

该文件会保存在当前命令提示符所在的目录下（通常为 C:\Users\你的用户名\requirements.txt）。升级完成后，可以通过该文件批量还原需要的库。

二、下载与执行安装程序

升级的核心是获取官方发布的 Windows 安装器（Windows installer）。官方通常提供两种主要版本：32-bit 与 64-bit（当前绝大多数 Windows 10/11 系统均采用 64-bit 架构）。

1. 获取安装包

访问 Python 官方网站的 Windows 下载页面（python.org/downloads/windows/），选择稳定的最新正式版本（例如 Python 3.12.x 或 3.11.x），点击下载 Windows installer (64-bit) 可执行安装文件。

2. 安装选项的关键设置

双击运行下载后的 .exe 安装程序。在安装向导首页，有两项关键操作直接决定升级是否顺利：

• 务必勾选底部复选框：Add python.exe to PATH。这一步会自动将新版本的执行目录及脚本目录加入系统环境变量，避免后续手动配置 PATH。
• 勾选 Use admin privileges when installing py.exe（如存在）：确保 Python 启动器对全体用户生效。
• 建议点击 Customize installation（自定义安装），进入下一步核对可选组件：
  • 确保勾选 Documentation、pip、tcl/tk and IDLE 以及 Python test suite。
  • 特别确认 py launcher 处于勾选状态，且勾选 for all users。
• 在随后的“Advanced Options”（高级选项）中：
  • 勾选 Install Python for all users（可选，如勾选将安装至 C:\Program Files\Python312；未勾选则安装至用户应用目录）。
  • 勾选 Precompile standard library（预编译标准库，可提升首次加载速度）。
• 点击 Install 开始安装。

三、验证新版本与多版本管理

安装完成后，必须重新打开一个新的命令提示符窗口（已有窗口不会自动刷新环境变量缓存），进行版本校验。

1. 验证默认调用版本

在全新终端中输入：

python --version

如果输出显示新安装的版本号（例如 Python 3.12.3），说明新版本已成功注册为系统优先执行程序。

接着查看 pip 对应的版本和路径：

pip --version

确认其括号内的 Python 版本号与新版本完全对应。

2. 使用 Python 启动器（py.exe）查看与调用多版本

Windows 官方提供的 py 命令是管理多版本的利器。它被安装在 C:\Windows\py.exe，默认无需配置即可在任何路径执行：

py --list-paths

示例输出：

 -V:3.12 *        C:\Users\Username\AppData\Local\Programs\Python\Python312\python.exe
 -V:3.10          C:\Users\Username\AppData\Local\Programs\Python\Python310\python.exe

星号（*）代表当前默认使用的版本。如果需要在同一个系统里灵活执行不同版本，可使用版本参数：

py -3.10 script.py    # 使用 Python 3.10 运行
py -3.12 script.py    # 使用 Python 3.12 运行

四、恢复依赖环境与现代项目管理建议

新版本安装完毕后，原有的依赖包并不会自动带入新环境，需要按需重装或通过虚拟环境隔离维护。

1. 升级新环境中的基础工具包

首先确保新版本的 pip、setuptools 处于最新状态：

python -m pip install --upgrade pip setuptools wheel

2. 批量恢复依赖

如果需要将旧环境中的库恢复到新版本的全局环境中，进入之前生成 requirements.txt 的目录，执行：

pip install -r requirements.txt

3. 推荐做法：通过虚拟环境彻底杜绝“版本升级灾难”

在现代 Python 开发中，不建议把业务项目依赖全部堆砌在全局环境中。在项目目录下为新版本创建独立的虚拟环境是最安全的方式：

# 1. 进入项目所在目录
cd my_project

# 2. 指定使用新版 Python 创建虚拟环境 (.venv)
python -m venv .venv

# 3. 激活虚拟环境 (Windows CMD)
.venv\Scripts\activate.bat
# 若使用 PowerShell:
# .venv\Scripts\Activate.ps1

# 4. 在隔离的虚拟环境中安装依赖
pip install -r requirements.txt

这种模式下，即使系统全局升级了 Python，各项目的运行环境也完全独立，互不受影响。

五、旧版本处理与升级后常见故障排查

1. 旧版本需要卸载吗？

• 若项目已全部迁移或为个人学习环境：可以安全卸载旧版本。打开 Windows“设置” -> “应用” -> “已安装的应用”，搜索“Python”，找到旧版本（如 Python 3.10.8 (64-bit)）点击“卸载”即可。卸载会自动清理旧版的执行文件与注册表信息。
• 若旧项目严重依赖老版本专有库：完全可以保留旧版，两个版本分别位于不同目录，互不干扰，通过 py -3.x 即可随时调用。

2. 常见问题一：安装新版后，运行 python --version 依然显示旧版本

这是因为系统环境变量 PATH 中，旧版本的路径条目排列在新版本条目的上方，系统检索时优先命中了旧版本。

解决步骤：

1. 按 Win + S 搜索并打开“编辑系统环境变量”。
2. 在“系统属性”窗口中点击右下角“环境变量”。
3. 在“系统变量”或“用户变量”中找到名为 Path 的条目，选中并点击“编辑”。
4. 在列表中找到新版本的两个路径（如 ...\Python312\ 和 ...\Python312\Scripts\），点击右侧的“上移”按钮，将其移动到旧版本路径之上。
5. 依次点击“确定”保存所有窗口，并重新打开命令提示符测试。

3. 常见问题二：提示“Python 无法找到”或弹出 Windows 商店页面

Windows 默认带有“应用执行别名”，会在未检测到有效 Python 时自动唤起微软商店。可在“Windows 设置” -> “应用” -> “高级应用设置” -> “应用执行别名”中，将 python.exe 和 python3.exe 的别名开关关闭，避免别名劫持真实安装路径。

六、总结

升级 Windows 下的 Python 版本本质上是一次“安装新版本 + 重定向环境指针”的过程。整个流程的关键点在于：安装时务必勾选 Add python.exe to PATH，安装后新开终端验证；理解 Windows 多版本共存机制，善用系统自带的 py 启动器灵活调用各版本；并通过导出 requirements.txt 或借助 venv 虚拟环境进行依赖管理。掌握这套规范流程后，即可在保证旧有工程平稳运行的前提下，快速平滑地完成 Python 版本升级。