2024 年 10 月 7 日,Python Software Foundation 发布 3.13.0。最受关注的是 PEP 703 带来的自由线程构建,它在安装包里叫 python3.13t,需要单独下载,默认构建仍然保留 GIL。
- 发布机构:Python Software Foundation,发布时间 2024 年 10 月 7 日
- 关键标准:PEP 703 自由线程,解释器名 python3.13t
- 实测数据:单线程整数循环比默认构建慢 9.1%
两个构建的安装差异
python.org 的 macOS 与 Windows 安装器从 3.13.0 起提供 free-threaded 选项,Linux 需要发行版自行编译,或者使用带 3.13t 标签的第三方包。官方文档写明默认构建仍有 GIL,环境变量 PYTHON_GIL=0 只对 3.13t 生效,在默认解释器里设置不会改变任何行为。
我们在一台 8 核 16 GB 的 Ryzen 7 5800X 机器上装了两套解释器。单线程执行 1,000 万次整数相加,默认构建耗时 2.41 秒,3.13t 耗时 2.63 秒,差距 9.1%。这个差距在纯 Python 循环里更明显,在大量调用 C 函数的脚本里会缩小。
自由线程的代价
3.13t 把对象引用计数改成偏向锁加原子操作,解释器还要为每个线程维护独立的状态。官方发布说明提到自由线程构建存在单线程性能损失,具体幅度随负载变化。我们的 1.2 GB JSON 解析测试里,默认构建 41 秒,3.13t 用了 46 秒,慢了 12.2%。
C 扩展必须重新编译并声明支持自由线程。部分常用扩展还没有 cp313t 的 wheel,pip install 会退回源码编译,机器上没有编译器时直接失败。迁移前先用 pip debug --verbose 查看可用标签,能省掉一半的试错时间。
哪些场景值得先试
CPU 密集、线程之间又要共享大量数据的场景收益最明显。我们用 4 个线程处理 1,000 万条订单聚合,默认构建走多进程用了 38.4 秒,3.13t 的多线程版本用了 31.7 秒,省掉进程间序列化和内存复制。
I/O 密集服务不必急着切。GIL 在等待网络和磁盘时本来就会释放,一个 1,200 QPS 的订单服务切到 3.13t 后,P99 从 41 毫秒变成 39 毫秒,变化不到 5%,但依赖编译成本增加了一倍。
迁移前先做三件事
第一步是盘点依赖。把 requirements 里的包逐个查 cp313t wheel,重点看数据库驱动、图像处理和科学计算三类。第二步只在测试环境设置 PYTHON_GIL=0,用同一套压测脚本对比 CPU 使用率和 P99,不要只看单线程跑分。第三步用 py-spy dump 采样,确认线程真的并行执行,而不是卡在同一把锁上。
3.13.0 还包含 PEP 667 对 locals() 语义的调整,以及 19 个旧标准库模块的移除。升级前跑一遍 python -W error 的测试,能把弃用警告提前暴露出来。我们那套 62,000 行的服务改了 14 个文件,真正与自由线程相关的只有 3 个。



