Python 3.10 停更升级

先说结论:Python 3.10 在 2026 年 10 月 1 日正式停更,最终版是 3.10.22,之后不会再有任何安全补丁。你的代码不会在那天突然停掉,但从那天起新发现的漏洞就没人修了。推荐的升级目标是 Python 3.14,支持到 2030 年 10 月;如果某个关键依赖还不支持 3.14,先落到 3.13 过渡。本文的安装和验证步骤都在本地跑过,版本号以官方文档为准。

一、停更到底意味着什么

Python 每个版本大约有五年的支持期:两年修 bug,之后只修安全问题。3.10.0 是 2021 年 10 月 4 日发布的,五年一到,2026 年 10 月 1 日发布 3.10.22 之后,整个分支就冻结了。用官方开发者指南的话说,发布周期冻结之后,不再接受任何改动。

停更不等于代码立刻不能跑,等于安全债开始累积。云厂商的动作比这更实在:AWS Lambda 在 2026 年 10 月 31 日弃用 python3.10 运行时,2027 年 7 月 29 日起禁止新建,8 月 31 日起禁止更新;Google Cloud Run Functions 也从 10 月 4 日起开始弃用 3.10 运行时。还在 3.10 上的服务,迟早会被平台推着走。

二、选哪个版本当目标

先看支持期,选一个能让你几年不用再折腾的版本:

版本状态支持到最新补丁(2026 年 11 月)
3.11仅安全修复2027 年 10 月3.11.18
3.12安全修复2028 年 10 月3.12.16
3.13安全修复2029 年 10 月3.13.18
3.14修 bug 中2030 年 10 月3.14.10
3.15修 bug 中2031 年 10 月3.15.2

默认目标选 3.14:还在修 bug 的阶段,支持期最长,生态也跟上了。如果某个关键依赖还不支持 3.14,先落到 3.13 过渡,等依赖跟上再升。3.15 是 10 月 9 日才发布的最新版,功能最全,但太新了,生产环境可以先观望——不过它的生态跟进速度不错,10 月底有人统计过,PyPI 前 500 的包里 97% 已经能直接装 wheel。

别选 3.11 和 3.12 当目标:3.11 只剩不到一年支持期,升上去很快又要再升一次。

三、升级前先检查:三条命令

动手之前,先摸清自己项目的现状:

python3 --version
pip freeze > requirements.txt
grep -rnE '\b(import|from)\s+(distutils|imp|asyncore|asynchat|smtpd|cgi|telnetlib|aifc|audioop|chunk|uu|xdrlib|imghdr|mailcap|pipes|nntplib)\b' --include='*.py' .

第一条确认当前版本;第二条把依赖冻结下来,升级后照单重装;第三条是关键——在代码里搜被删掉的标准库模块,有命中就先记下来,下一节会讲替换办法。搜的时候别只看自己的代码,setup.py 和老的工具脚本也算上。

顺带查一下顶层依赖的支持情况:去 PyPI 上看一眼每个主要依赖的最新版支不支持 3.14,或者直接看它的 requires-python。依赖越多,这一步越值得做,省得装完才发现某个包没有 3.14 的 wheel。

四、装新版本:uv 最快

装新 Python 有四种常见办法,推荐 uv,我在本地验证过:

uv python install 3.14
uv run --python 3.14 --no-project python --version

实际输出:

Installed Python 3.14.10 in 3.45s
Python 3.14.10

一条命令就装好 3.14.10,不用管编译依赖,也不碰系统 Python。其他办法也列一下:

# pyenv
pyenv install 3.14.10
pyenv local 3.14.10

# Ubuntu / Debian,用 deadsnakes PPA
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update
sudo apt install python3.14 python3.14-venv

# macOS
brew install python@3.14

注意:系统自带的 Python 别动。Ubuntu、macOS 的系统工具依赖系统 Python,升级系统 Python 是最常见的翻车方式。新版本装在用户目录或独立路径,用虚拟环境隔离才是正道。

五、重建虚拟环境、装依赖、跑测试

旧的虚拟环境不能直接搬过去,虚拟环境里写死了旧解释器的路径。正确做法是新建一个:

uv venv --python 3.14
source .venv/bin/activate
uv pip install -r requirements.txt

或者用标准库:

python3.14 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

装完先别急着改代码,跑一遍测试套件:

python -m pytest

测试全过,升级就完成了一大半。有失败的先看报错,大概率是下一节的删模块问题,或者某个依赖的版本太旧。依赖装不上时,先看这个包有没有新版支持 3.14,没有的话要么找替代品,要么暂时把目标降到 3.13。

依赖这一步有个省事的查法:装之前先去 PyPI 看一眼每个主要依赖的最新版支不支持 3.14,或者直接看它的 requires-python 字段。依赖越多,这一步越值得做,省得装完才发现某个包没有新版的 wheel,又得回头降版本。

六、最容易踩的坑:25 个被删的标准库模块

从 3.10 到 3.14,标准库一共删了 25 个模块。3.12 删了 distutils、imp、asyncore、asynchat、smtpd;3.13 删了 lib2to3 和 PEP 594 的 19 个“死电池”,包括 cgi、telnetlib、aifc、audioop、chunk、uu、xdrlib、imghdr、mailcap、pipes、nntplib 等;3.14 又删了 ast.Num、ast.Str 这些。

我在刚装好的 3.14.10 上实测过,报错长这样:

ModuleNotFoundError: No module named 'distutils'
ModuleNotFoundError: No module named 'cgi'

常见替换办法:

被删的模块删于替换办法
distutils3.12setuptools(它自带一个兼容层),或 sysconfig、packaging
imp3.12importlib
smtpd3.12PyPI 上的 aiosmtpd
cgi3.13urllib.parse、email.message,或 PyPI 上的 legacy-cgi
telnetlib3.13telnetlib3 或 paramiko
imghdr3.13filetype 或 Pillow
pipes3.13subprocess + shlex.quote()
uu3.13base64
asyncore / asynchat3.12asyncio

关于 distutils 有个坑要特别提醒:setuptools 自带一个 distutils 兼容层,所以在装了 setuptools 的机器上 import distutils 可能照样成功,但在没装 setuptools 的精简镜像里就会报错。在自己机器上能 import 不等于部署环境没问题,部署前一定要在干净环境里验证。

七、升上去能捡到什么

升级不只是为了续命,中间四个版本的新东西也值得拿:

  • 3.11 更快:Faster CPython 项目让解释器提速,官方称比 3.10 快 10%–60%,不用改代码就能受益。
  • 3.12 的 f-string 更好写:PEP 701 之后,f-string 里可以复用同种引号、写多行表达式、加注释,模板字符串不再束手束脚。
  • 3.13 的自由线程和 JIT:实验性的无 GIL 构建和即时编译器,对多线程 CPU 密集型任务有帮助。
  • 3.14 的模板字符串和 uuid7:t"..." 模板字符串(PEP 750)让字符串模板可以当成结构化数据处理;uuid 模块新增了 v6、v7、v8 版本;compression.zstd 进了标准库。我在 3.14.10 上验证过,uuid.uuid7()、compression.zstd 和 t"hello {name}" 都能直接用。
  • 3.15 的 lazy imports:lazy import 语法让模块第一次用到时才加载,启动慢的命令行工具受益最大;另外 open() 默认按 UTF-8 编解码,跟平台 locale 无关。

直接上 3.15 的话多注意一条:open() 不写 encoding 参数时,以前按系统 locale 解码,现在一律按 UTF-8。读 GBK 编码的文件又不写 encoding,会直接报 UnicodeDecodeError。这是 3.15 的变化,升到 3.14 不受影响。

八、升级后验证清单

最后按这个清单过一遍,没问题再删旧环境:

  1. python --version 确认是目标版本,pip list 核对依赖都在。
  2. 测试套件全过,至少核心流程跑通。
  3. 服务能正常启动,日志里没有 ModuleNotFoundError 和 DeprecationWarning 刷屏。
  4. CI 配置、Dockerfile 基础镜像、pyproject.toml 里的 requires-python 都改成新版本。
  5. 旧解释器和旧虚拟环境先别删,留一个版本周期当回滚。

一句话总结:3.10 已经停更,3.14.10 是今天最稳的目标。先 grep 找被删的模块,再用 uv 一条命令装新版,重建虚拟环境、跑通测试,半天就能升完。拖着不升,省下的是一下午,欠下的是之后每个新漏洞都无人修的安全债。