
先说结论: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'
常见替换办法:
| 被删的模块 | 删于 | 替换办法 |
|---|---|---|
distutils | 3.12 | setuptools(它自带一个兼容层),或 sysconfig、packaging |
imp | 3.12 | importlib |
smtpd | 3.12 | PyPI 上的 aiosmtpd |
cgi | 3.13 | urllib.parse、email.message,或 PyPI 上的 legacy-cgi |
telnetlib | 3.13 | telnetlib3 或 paramiko |
imghdr | 3.13 | filetype 或 Pillow |
pipes | 3.13 | subprocess + shlex.quote() |
uu | 3.13 | base64 |
asyncore / asynchat | 3.12 | asyncio |
关于 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 不受影响。
八、升级后验证清单
最后按这个清单过一遍,没问题再删旧环境:
python --version确认是目标版本,pip list核对依赖都在。- 测试套件全过,至少核心流程跑通。
- 服务能正常启动,日志里没有
ModuleNotFoundError和DeprecationWarning刷屏。 - CI 配置、Dockerfile 基础镜像、
pyproject.toml里的requires-python都改成新版本。 - 旧解释器和旧虚拟环境先别删,留一个版本周期当回滚。
一句话总结:3.10 已经停更,3.14.10 是今天最稳的目标。先 grep 找被删的模块,再用 uv 一条命令装新版,重建虚拟环境、跑通测试,半天就能升完。拖着不升,省下的是一下午,欠下的是之后每个新漏洞都无人修的安全债。