PYTHON：Python 新版本下载安装更新py文件Pycharm运行指南

PYTHON：Python 新版本下载安装更新Pycharm实操指南

摘要

要稳定地安装并切换到全局刚刚安装的新版本 Python，应优先使用官方 Windows 安装器完成逐页配置，再用 Python 启动器（Python Launcher, py）设定默认版本，必要时配合环境变量 PATH 顺序调整。本文给出逐页选项说明、命令行示例（含逐行注释）、常见名词表，以及一图总览，确保“装得上、跑得通、切得到”。

---

一、概述

本指南只覆盖“安装新版本 Python 与替换为系统默认版本”两件事。这意味着：不涉及 IDE、项目依赖、虚拟环境等拓展话题，所有步骤均围绕“全局 Python 的正确安装与切换”展开。

1.1 核心术语与概念一览

下表对涉及的关键术语在首次出现时给出解释，避免含糊表述。

名称	全称与缩写	定义与作用
环境变量 PATH（Path Environment Variable, PATH）	PATH	Windows 用于查找可执行程序的有序目录列表；谁排在前面就先命中谁
命令提示符（Command Prompt, CMD）	CMD	经典 Windows Shell，常用命令行环境
Windows 终端（PowerShell, PS）	PowerShell, PS	现代化 Shell，语法与 CMD 不同，但均可执行外部程序
Python 启动器（Python Launcher, py）	Python Launcher, py	Windows 专用的多版本选择器；可通过 py -3.12 明确调用目标版本
用户账户控制（User Account Control, UAC）	UAC	Windows 的权限提升确认机制；安装到系统目录需要通过
长路径（Win32 Long Paths, LongPathsEnabled）	Long Paths	解除传统 260 字符路径限制，避免包安装或虚拟环境创建时因路径过长报错
包管理器（Windows Package Manager, winget）	winget	Windows 官方命令行应用商店；可一键安装指定版本 Python

要点：py 启动器不受 PATH 顺序影响，能稳定指向指定版本。因此优先用 py 设默认，再视情况微调 PATH，是更稳妥的切换策略。

---

二、下载安装包与版本选择

官方安装器（Windows installer 64-bit）是最稳的安装方式。它提供逐页选项，可精确控制“为所有用户安装、写入 PATH、启用长路径”等关键动作。

2.1 下载渠道与版本定位

• 官方下载页：https://www.python.org/downloads/windows/
• 在 Stable Releases 中选择目标版本（3.11.x / 3.12.x / 3.13.x）。
• 进入该版本页面，在 Files 区选择 Windows installer (64-bit)，文件名形如 python-3.12.x-amd64.exe。

建议优先选用 3.12 或 3.11 的最新补丁版本。理由：生态成熟、二进制轮子齐全、兼容性好。

2.2 安装向导逐页逐项（以 3.12/3.13 为例）

2.2.1 第 1 页：Install Python 3.xx（欢迎页）

• ✅ Add python.exe to PATH —— 将 Python 与 pip 自动加入 PATH，方便全局调用。
• ✅ Use admin privileges when installing py.exe（若出现）—— 以管理员权限安装 py 启动器，便于多版本管理。
• 操作：点击 Customize installation（不要直接 Install Now）。

2.2.2 第 2 页：Optional Features（可选组件）

• ✅ pip（必须）
• ⬜ Documentation（可选；离线查文档时有用）
• ✅ tcl/tk and IDLE（建议；部分工具依赖 Tk）
• ⬜ Python test suite（一般不需要）
• ✅ py launcher（建议；如有 for all users 也勾上）
• 操作：点击 Next。

2.2.3 第 3 页：Advanced Options（高级选项）

• ✅ Install Python 3.xx for all users —— 安装到系统目录，形成“全局”版本（默认 C:\Program Files\Python3xx\）。
• ✅ Add Python to environment variables —— 向系统 PATH 写入 Python 与 Scripts 目录。
• ✅ Associate files with Python —— 关联 .py 等文件扩展名。
• ✅ Create shortcuts for installed applications —— 创建快捷方式（可选）。
• ⬜ Precompile standard library —— 预编译标准库（安装更久，按需）。
• 其他 Debug 相关选项通常不勾。
• Customize install location：尽量别安装在C盘。建议手动指定为 D:\RootPython3xx\（如 Python312）。
• 操作：点击 Install 开始安装；若出现 UAC 提示，点 Yes。

2.2.4 完成页：Setup was successful

• ✅ Disable path length limit —— 启用长路径（设置注册表 LongPathsEnabled=1），避免路径过长错误。
• 点击 Close 退出安装器。

2.3 一键安装示例（winget 方案）

在某些场景（批量部署、无人值守）可用 winget 安装。尽管无安装器界面，但同样可与 py 启动器配合达成“默认版本切换”。

在以管理员身份打开的 PowerShell 中运行如下示例：

winget install -e --id Python.Python.3.12  # 使用 Windows 包管理器安装 Python 3.12（精确 ID 匹配）
winget list Python.Python                  # 列出与 Python 相关的已安装包，核对是否安装成功
py -0p                                     # 列出 Python 启动器可识别的所有版本，确认 3.12 已出现

上述命令行片段的上下文：先用 winget 安装，再用 py -0p 验证启动器视图是否包含新版本；如果需设为默认，继续在下一章执行 setx PY_PYTHON。

---

三、安装后验证与快速自检

安装完成后务必验证版本与命中顺序。这一步可以在 CMD 或 PowerShell 完成。

示例（CMD/PowerShell 通用；逐行附注释）：

python --version                    & REM 查看系统当前命中的 Python 版本，应返回 Python 3.xx.x
where python                        & REM 查看命令查找顺序，第一条应是 C:\Program Files\Python3xx\python.exe
py -0p                              & REM 使用 Python 启动器列出所有可用版本，确认新版本已登记
py -3.12 --version                  & REM 强制用 3.12 执行以排除 PATH 干扰，应返回 Python 3.12.x（示例版本）

运行完毕后，你应明确“当前 python 命令命中了哪个可执行文件”，以及“py 能否找到刚装的新版本”。

---

四、将系统默认切换到新版本

4.1 先枚举“当前版本与路径”

先看清楚系统里有哪些 Python、各自路径、以及 python 命令当前命中了谁。

where python                        & REM 列出 python 命令的命中顺序（从上到下优先级依次降低）
py -0p                              & REM 用 Python 启动器列出所有可用版本及其绝对路径
py -3.12 --version                  & REM 以 3.12 为例，确认该版本存在且可调用（若换版本，请改数字）

预期示例：

• C:\Program Files\Python312\python.exe（3.12，新版本目标）
• D:\RootAnaconda\python.exe（3.9，历史/Anaconda 版本）

---

4.2 设定“系统默认”的推荐顺序

图形界面路径： Win + R → sysdm.cpl → 高级 → 环境变量 → 编辑 Path（先“用户变量”，再“系统变量”都看一遍）。

将以下两条置顶（若不存在则新建）：

• D:\RootPython312\
• D:\RootPython312\Scripts\

将旧版/Anaconda 相关目录后移或暂时禁用：

• 例：D:\RootAnaconda\ 及其 Scripts\、Library\bin 等。

保存退出后，重新打开终端并验证：

where python                        & REM 第一条应为 C:\Program Files\Python312\python.exe
python --version                    & REM 现在应显示 Python 3.12.x（或你的目标版本）
pip -V                              & REM 应来自 Python312\Scripts（确保 pip 同步到新版本）

---

4.3 Pycharm中代码.py文件运行配置（Run/Debug Configuration）：窗口入口 & 标准配置

–

4.3.1 打开方式（任意一种）

1. 菜单路径
   运行 → 编辑配置…（Run → Edit Configurations…）

2. 右上角工具栏
   编辑器右上角靠近绿色三角▶旁的小下拉箭头 ▾ → 编辑配置…

3. 快捷键
   Alt+Shift+F10 打开运行配置选择器 → 再按 0（编辑配置）
   或 Ctrl+Shift+A → 搜“编辑配置”。

进入后你会看到左侧是配置列表（如图的 Python3.12），右侧是详细参数面板。

---

4.3.2 新建一个 Python 运行配置

1. 左上角 + → 选择 Python（不是“Python 单元测试”）。

2. 右侧按下面填写（最关键的 4 项打 ★）：
   

• 名称：例如 superstore_pr（自定义即可）。

• ★ 脚本路径：点右侧文件夹，选你的脚本 superstore_pr.py。

• 参数（可选）：脚本需要命令行参数时填写。

• ★ Python 解释器：下拉选择你要用的解释器。

• ★ 工作目录：点右侧文件夹

  • 推荐：选 项目根目录（含 data/、figs/ 的最上层文件夹）。
  • 用相对路径读写文件时，工作目录必须正确，否则会报“工作目录不存在/找不到文件”。

• 环境变量：默认有 PYTHONUNBUFFERED=1，保留即可。需要自定义时点“…”新增。

• 将内容根添加到 PYTHONPATH：✅ 勾选

• 将源根添加到 PYTHONPATH：✅ 勾选

• 执行：

  • 「在输出控制台中模拟终端」：保持不勾。
  • 「使用 Python 控制台运行」：保持不勾（避免老版本 pydev 的警告和性能开销）。

3. 点 应用 → 确定。右上角绿色三角 ▶ 即可运行；甲壳虫 🐞 调试。

---

4.3.3 把“默认模板”也设好（省去每次重复）

1. 窗口左下角 编辑配置模板…

2. 选左侧 Python 模板，右侧设置：

   • Python 解释器：选你的 Python 3.12
   • 工作目录：选 项目根目录
   • 勾选 将内容根/源根添加到 PYTHONPATH

3. 应用/确定。
   以后右键脚本 → 运行，都会继承这些默认值。
   

---

---

五、结论

让新装的 Python 成为系统默认的关键，在于“安装阶段的正确勾选”与“切换阶段优先使用 py 启动器设定默认”。必要时，再通过 PATH 调整巩固 python 命令的命中顺序，辅以长路径启用以减少未来的路径报错。遵循本文方案，你可以在不破坏旧环境的前提下，稳定切换到 3.11/3.12/3.13 等新版本。