Python 核心

Python 3.15 已发布:升级前先过这 7 关

3.15.0 于 2026 年 10 月发布,3.10 已在同月停止维护。升级不是改一行版本号,本文给出一份可执行的检查清单。

约 3 分钟1163 字

Python 3.15.0 在 2026 年 10 月 9 日发布,10 月 25 日已有 3.15.2;与此同时,3.10 于 2026 年 10 月 1 日结束生命周期。对线上项目来说,升级的价值不只是新语法,更是安全更新和依赖生态的持续可用。

先确认你到底要升到哪一支

目前 3.14 处于 bugfix 阶段,3.13 处于 security 阶段,3.15 是最新特性版本。生产环境通常有两条稳妥路线:跟随 3.14 的 bugfix 版本,或在充分验证后升级到 3.15。不要从 3.10 一步跨到最新版再一次性排查所有问题。

  • 先升补丁版本,再升次版本。同一分支内的升级风险最低。
  • 先升开发/CI 环境,观察一到两周再动生产。
  • 锁文件要一起更新。仅改 python_requires 而不重新解析依赖,等于没升级。

检查清单

  1. 依赖兼容性。用 pip install --dry-run -U 或 uv lock --upgrade 看解析结果,重点盯带 C 扩展的包。
  2. C 扩展是否有对应 wheel。没有 wheel 就会现场编译,CI 里缺编译工具链是升级事故的高发原因。
  3. 已移除的标准库模块。distutils 早已退出标准库,仍在用的构建脚本要迁到 setuptools 或 hatchling。
  4. 类型检查。升级后跑一遍 mypy --strict 或 pyright,新版本类型存根常常暴露此前被忽略的问题。
  5. 异步代码。asyncio 的弃用项逐年清理,关注 loop 参数与显式事件循环写法。
  6. 序列化边界。pickle 与跨版本 worker 通信要测,尤其混跑新旧进程的滚动发布期间。
  7. 回滚预案。镜像保留上一版本,数据库迁移保持向后兼容,先能回滚再谈升级。

用容器把升级关进笼子

# 同一份 requirements,只换基础镜像做对比验证
FROM python:3.14-slim AS py314
FROM python:3.15-slim AS py315

# CI 中分别执行:
# uv pip compile pyproject.toml -o requirements.txt
# pytest -q && mypy --strict src/ && ruff check .

值得现在就做的准备

把 python_requires 写清楚,给 CI 加一个最低支持版本和一个最新版本的双矩阵,把 DeprecationWarning 打开成可见输出。升级之所以痛苦,通常不是因为新版本有多难,而是因为旧代码里积累的隐式假设太久没人提醒。

升级的目标不是追新,而是让下一次升级变成一件无聊的事。