Appearance
Python 升级指南
本指南说明在 Windows、macOS、常见 Linux 发行版 上把 Python 升到较新版本的常用做法。若你尚未安装 Python，请先阅读 环境搭建。升级后若使用虚拟环境，通常需要 按新版本重建虚拟环境，详见 虚拟环境的创建。
升级前先确认几件事
- 当前版本：在终端执行
python --version或python3 --version（Windows 上若只有py启动器，可用py --version）。 - 目标版本：到 python.org/downloads 查看当前维护中的 3.x 分支；生产项目需对照官方 What’s New 与依赖库的兼容性说明。
- 虚拟环境与项目：解释器升级后，旧目录里的
venv往往 不能 直接复用，应新建环境再安装依赖；重要项目升级前建议备份并跑一遍测试。
Windows
方式一：官方安装包（最通用）
- 打开 Python 官方下载页，下载对应架构的安装程序（多数为 64-bit）。
- 运行安装程序，勾选 Add python.exe to PATH（或 Add Python to environment variables，以安装界面为准）。
- 选择 Install Now 或 Customize installation。若要与旧版并存，可在自定义安装里改安装路径，或保留多版本由 Python Launcher（
py）选择。
安装结束后新开一个 命令提示符 / PowerShell 窗口，执行：
powershell
python --version
py -0ppy -0p 会列出已安装的 Python 路径，便于确认是否指向新版本。
方式二：包管理器
winget（Windows 10/11 常见）：
powershell
winget search Python.Python
winget install Python.Python.3.12具体包名随官方发布更新，以 winget search 结果为准。
Chocolatey（需已安装 choco）：
powershell
choco upgrade python -y多版本并存与 py 启动器
系统可同时安装多个 3.x。运行指定版本示例：
powershell
py -3.12 -m venv .venv若 python 仍指向旧版，检查 环境变量 Path 中 Python 目录的顺序，或使用 py -3.x 调用。
Microsoft Store 版 Python
若 Python 来自 Microsoft Store，升级一般在 Microsoft Store → 下载和更新 中完成；其与官网安装包混用时，容易出现 PATH 优先级 问题，建议统一用一种来源并在终端里用 where python（CMD）或 Get-Command python（PowerShell）核对实际路径。
macOS
方式一：Homebrew（常用）
Apple Silicon / Intel 均可：
bash
brew update
brew upgrade python若需要安装 特定主版本（与系统里已有公式并存）：
bash
brew install python@3.12
brew link python@3.12 --force --overwritebrew info python 会提示当前公式对应的版本与路径；链接操作有覆盖风险，执行前请确认没有依赖旧路径的脚本。
方式二：pyenv（适合多版本切换）
bash
brew install pyenv
pyenv install 3.12.7
pyenv global 3.12.7版本号请改为 python.org 上可用的发行版。使用 pyenv 时需在 shell 配置里初始化（pyenv init 的提示按文档添加到 ~/.zshrc 等）。
方式三：官方 macOS 安装包
从官网下载 .pkg 安装，步骤与 环境搭建 中「使用官方安装包」一致；适合不想装 Homebrew 的场景。
安装后验证：
bash
python3 --version
which python3Linux
发行版自带的 python3 往往偏保守，升级系统包 与 并行安装新版本 是两条常见路线；服务器上改动系统 Python 可能影响 apt/dnf 等工具，优先用 虚拟环境或 pyenv，或为项目单独装解释器。
Ubuntu / Debian
仅随发行版更新小版本（安全补丁级别，主版本未必变）：
bash
sudo apt update
sudo apt upgrade python3需要 比仓库更新的 3.x 时，常见做法是使用 deadsnakes PPA（Ubuntu 官方文档与社区常用；使用前请阅读 PPA 说明与支持你当前的 Ubuntu 版本）：
bash
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update
sudo apt install python3.12 python3.12-venv python3.12-dev将 3.12 换成你需要的主版本号。安装后命令一般为 python3.12，可与系统自带的 python3 并存。
Fedora
bash
sudo dnf upgrade python3若需模块流中的特定版本，可使用：
bash
dnf module list python按输出提示启用对应 stream（不同 Fedora 大版本选项不同）。
Arch Linux
bash
sudo pacman -Syu pythonArch 通常跟踪较新的上游版本，一次系统升级即可带上 Python 更新。
openSUSE Leap / Tumbleweed
bash
sudo zypper refresh
sudo zypper update python3RHEL / Rocky Linux / AlmaLinux
企业发行版多通过 AppStream 模块 或发行方文档提供较新的 Python，勿随意替换系统 /usr/bin/python3 以免破坏平台工具。请优先查阅当前大版本的官方发行说明，或使用 Software Collections、容器、pyenv 等隔离方式。
CentOS 老版本与 RPM 系细节（含 yum 依赖说明、源码安装到 /usr/local、误删系统 Python 后的救急思路）：CentOS 与 RHEL 安装 Python。
跨平台：Conda / Mamba
若使用 Miniconda / Anaconda / Mambaforge，在 对应环境 内升级解释器（示例）：
bash
conda activate 你的环境名
conda install python=3.12具体可升级到的版本受 channel 与依赖约束；升级后同样建议 重建 或 重新安装 该环境中的关键包并做回归测试。
升级后建议做的检查
bash
python3 --version
python3 -m pip --version
python3 -m pip install --upgrade pip用新版本 新建 虚拟环境并安装项目依赖；旧 venv 目录可保留作对照，确认无问题后再删除。