CPython 3.14.0a5 版本解读核心虚拟机重构、自由线程加固与标准库新特性全景【免费下载链接】cpythonThe Python programming language项目地址: https://gitcode.com/GitHub_Trending/cp/cpython本文基于 CPython 官方仓库中的发布记录 Misc/NEWS.d/3.14.0a5.rst系统梳理 CPython 3.14.0a5预计 2025-02-11 发布在字节码虚拟机、自由线程free-threading、C API、安全修复与标准库等维度的全部关键变更。读完本文你将理解该版本中 BINARY_SUBSCR 被 BINARY_OP 取代、尾调用tail-call解释器引入等架构级改动掌握bytearray.resize、os.readinto、pathlib.Path.info、uuid.NIL/MAX、asyncio调用图 API 等新能力的用法并了解一批安全漏洞的修复细节与受影响场景。一、核心虚拟机与内建Core and Builtins变革3.14.0a5 的核心虚拟机改动集中体现了 CPython 在指令集精简、JIT 深化与自由线程正确性三条主线上的推进。1.1 字节码指令集重构BINARY_SUBSCR 合并进 BINARY_OP本版本实施了一项影响深远的指令集改动Replace the opcode BINARY_SUBSCR and its family by BINARY_OP with oparg NB_SUBSCR.将 BINARY_SUBSCR 及其家族指令替换为带 oparg NB_SUBSCR 的 BINARY_OP。这是 gh-issue 100239 系列工作的延续。此前同系列已新增BINARY_OP_EXTEND指令——它从内联缓存inline cache中读取一对函数guard 与特化函数并执行用于在运行时按操作数类型对二元运算做特化派发本版本又Specialize BINARY_OP for bitwise logical operations on compact ints为紧凑整数上的按位逻辑运算新增了特化路径。配合指令集合并CPython 减少了操作码数量把更多二元运算收敛到统一的分发/特化框架中。感兴趣可以在 Include/opcode_ids.h 与 Python/opcode_metadata.py 中查看当前指令 ID 的编排。1.2 新增尾调用解释器最高 30% 的 Python 密集负载加速A new type of interpreter has been added to CPython. This interpreter uses tail calls for its instruction handlers. Preliminary benchmark results suggest 7-11% geometric mean faster on pyperformance (depending on platform), and up to 30% faster on Python-intensive workloads.本版本新增了采用尾调用tail call实现指令处理器的解释器形态。初步基准显示 pyperformance 几何平均提升 7%–11%视平台而定Python 密集负载最高提升约 30%。需要强调两点事实边界其一这是初步基准结果并非最终承诺其二该解释器当前仅在新版编译器如 clang-19上启用其他编译器仍走原有解释器路径。这说明 CPython 正在同时维护多条解释器实现路线经典 switch 解释器、尾调用解释器与实验性 JIT并以编译器能力为门槛做运行时选择。1.3 JIT 与生成器性能Improve JIT performance for generators为生成器改进了 JIT 性能Improve memory layout of JIT traces优化了 JIT trace 的内存布局Diego Russo 提交Collect JIT memory stats using pystatsJIT 内存统计接入pystats便于开发者用-X pystats观测 JIT 内存行为同时移除了实验性 JIT 编译器的部分内部测试 API见 C API 板块。1.4 自由线程free-threading构建的正确性加固自由线程构建--disable-gil在本版本修复/加固了一批并发问题GC 并发化_Py_qsbr_reserve竞态修复PyGC_Enable/PyGC_Disable/PyGC_IsEnabled改为原子操作见 C API 板块free-threaded GC 新增marking phase从已知根如sys模块字典出发标记所有可达对象与分代、增量 GC 不同的设计使其通常每个对象工作量更少、更快GC 预取优化当经历完整回收后仍存活的长生命周期对象数超过阈值时条件启用 CPU prefetch 指令提高缓存命中率、缩短回收时间容器线程安全PyList_Insert、PyList_SetItem在线程安全上被修复hashlib.sha256在 free-threading 下可能产生的多余引用问题被修正异常路径修复了 free-threaded 构建下抛出MemoryError时的竞态条件warnings 模块_warnings_runtime_state.mutex改为递归互斥锁并在更新filters与_filters_version时持锁配合_acquire_lock/_release_lock暴露给 Python 层规避数据竞争此前_release_lock()无锁可释放时的崩溃也已修复。1.5 调试、错误信息与细节行为修正f-string 调试表达式修复f{expr}在表达式含!时显示不完整的问题并将调试表达式按原始字符串raw string处理非法转义序列告警改进SyntaxWarning文案明确说明未来版本将升级为SyntaxError并给出Did you mean \\e?之类的修复建议REPL 体验退出时恢复终端控制字符修复终端 resize 时的报错修复 PyREPL 在os.environ被覆盖为非法值时崩溃修复输入超长行时连续两次 CTRL-Z 导致的_pyrepl崩溃补全菜单改为显示在当前行下方sys.monitoring / sys.settrace处理LINE事件的时间不再随代码对象行数线性增长sys.platformFreeBSD 上不再附带主版本号恒为freebsd而非freebsd13/freebsd14依赖该字符串做平台判断的代码需注意tracebackexcept*包裹裸异常时补上对应帧修复TracebackException._format_syntax_error对带自定义元数据异常的处理生成器帧修复生成器帧存活超过其生成器时访问gi_frame.f_locals崩溃的问题导入路径当前工作目录因权限无法确定时import 不再抛出PermissionError。二、安全修复六个值得关注的问题本版本安全板块覆盖 URL 解析、C API、email、imaplib 等领域urlsplit/urlparse 主机名校验gh-129248 相关安全项修复了主机名解析未拒绝包含方括号[]的域名的问题——按 RFC 3986 Section 3.2.2PySys_AddWarnOptionUnicode 空指针解引用修复了该 C API 在特定输入下可能触发NULL指针解引用的问题email 折叠引号字符串现代 email policy 下折叠跨行的带引号字符串原先会丢失引号与内部转义可能被构造来伪装 header 行若渲染后的邮件被传输或重新解析imaplib 拒绝服务连接恶意服务器时可能分配任意大量内存触及虚拟地址空间上限后引发MemoryError或进程崩溃在所有分配内存都被实际触摸并回落到真实内存的特殊系统/构建上可能耗尽资源syslog.openlog 空指针解引用audit hook 抛异常时触发HTTPResponse.read 负长度修复负读取大小处理错误Patch by Yury Manushkin。三、标准库新增能力按模块速览3.1 容器与基础类型bytearray.resize新增bytearray.resize(n)原地调整缓冲区大小。增大时新区域清零缩小时截断对子类同样生效非法参数抛出TypeError缺参或多参、ValueError负数、MemoryError超内存。完整的参数与边界行为可参考 Lib/test/test_bytes.py 中的test_resize用例os.readinto新增os.readinto(fd, buffer)从文件描述符直接读入 buffer 协议 对象避免中间对象与拷贝。_pyio.FileIO.readinto已改用该函数优化见 Lib/_pyio.pyarray.array修复对已耗尽的迭代器调用setstate崩溃的问题ast.unparse不再在无必要时复用引号类型保证 round-trip 输出更稳定。3.2 asyncio 与并发调用图分析 API新增asyncio.capture_call_graph与asyncio.print_call_graph实现位于 Lib/asyncio/graph.py可捕获当前任务或指定 Future 的异步调用图FutureCallGraph(future, call_stack, awaited_by)结构asyncio.staggered.staggered_race支持上报调用图信息并修复了其泄漏任务与未处理异常的问题eager task 的 name 关键字asyncio.loop.create_task、asyncio.create_task、TaskGroup.create_task对 eager 任务支持name关键字kwargs 会透传给任务工厂loop.set_task_factory设置TaskGroup移除了导致取消丢失的错误优化Barrier修正asyncio.Barrier与threading.Barrier的ValueError消息传输层修复_SelectorTransport在写入完成前被关闭时的异常与不完整写入问题。3.3 文件与路径pathlib.Path.info新增Path.info属性与pathlib.types.PathInfo协议Lib/pathlib/types.py。该对象支持查询文件类型并内部缓存os.stat结果Path.iterdir生成的对象会利用扫描父目录得到的文件类型信息初始化zipfilewritestr尊重SOURCE_DATE_EPOCH环境变量以实现可复现构建ZipFile.open对未压缩、未加密的只读 zip 支持完整随机访问shutilshutil.copy、copy2、copyfile默认使用os.copy_file_range为 btrfs/XFS 提供写时复制COW机会、为 NFS 提供服务端复制机会_pyio.FileIOreadall()采用与_io.FileIO.readall()一致的缓冲分配/增长算法readinto利用os.readinto避免多余对象与拷贝。3.4 网络与协议logging.handlers.SysLogHandler新增 sockettimeout关键字参数SMTPHandler修复secure参数处理imaplib新增 IMAP4IDLE支持RFC 2177 风格的服务器推送等待模式ctypes.util.dllist新增列出当前进程已加载共享库的函数http.cookies支持PartitionedCookie 标志CHIPS 相关。3.5 数据格式与解析uuid.NIL / uuid.MAX新增 NIL00000000-0000-0000-0000-000000000000与 MAXffffffff-ffff-ffff-ffff-ffffffffffff常量对应 RFC 9562sqlite3用户自定义 SQL 函数参数个数非法时改抛sqlite3.ProgrammingError创建函数时处理内存不足修复sqlite3.Row在继承的description为None时可能段错误的问题csv修复写入超过 2GB 数据字段时的整数溢出csv导入时间通过按需导入re最多降低约 5 倍re不再隐式暴露为csv.relocale更新别名映射以匹配最新 X Org locale 别名与 Glibc 2.41 新增 localeconfigparser不再在每次读取时重建未命名 section。3.6 性能优化导入时间与热点路径3.14.0a5 对导入时间做了系统性的按需导入优化gettext导入时间最多降低约 10 倍按需导入rebase64导入时间最多降低约 6 倍不再导入reb16decode性能最多提升约 10 倍更高效地检查十六进制位pstats与zipfile导入时间最多降低约 20%移除多余typing导入subprocess通过惰性导入locale与signal提速threading惰性导入warningstomllib移除typing、string、tomllib._types导入optparse在无需打印帮助文本时减少导入开销。其他热点优化PyLong_FromUnsignedLong/PyLong_FromUnsignedLongLong/PyLong_FromSize_t为中等大小整数新增快速路径列表与元组迭代使用迭代器对象 freelistint去分配器微优化sys._is_immortal新增用于运行时识别 immortal 对象对应 C API 的PyUnstable_IsImmortal。3.7 其他行为变更与弃用颜色输出-E只忽略PYTHON_COLORS而不忽略FORCE_COLOR/NO_COLOR/TERMFORCE_COLOR/NO_COLOR为空字符串时修正行为颜色检测默认改用 stdout 的isattydifflib.HtmlDiff比较页支持暗色模式calendarCLI 高亮移入私有类highlight_day从公开TextCalendarAPI 移除turtle新增turtle.fill、turtle.poly、turtle.no_animation上下文管理器math域错误支持自定义消息math.sqrt、math.log、math.atanh为例pdb弃用pdb.Pdb.curframe_localsinline 模式下退出 pdb 显示确认提示并优雅退出string.Formatter自动编号模式支持属性/项访问如{.name}、{[1]}importlib为DEBUG_BYTECODE_SUFFIXES、OPTIMIZED_BYTECODE_SUFFIXES、WindowsRegistryFinder、ResourceLoader、SourceLoader.path_mtime补上弃用告警sysconfigexpand_makefile_vars弃用改用get_paths(vars...)is_python_build(check_home...)的弃用排期至 3.15并修复expand_makefile_vars的NameErrorcodecsreplace_errors、backslashreplace_errors、xmlcharrefreplace_errors修复UnicodeError.start/end处理warnings_release_lock()无锁可释放时的崩溃修复见上文。四、C API 变更新增、移除与弃用清单4.1 新增公开 APIPyUnstable_IsImmortal判断对象是否为 immortal对应 Python 层sys._is_immortalPyUnstable_TryIncRef与PyUnstable_EnableTryIncRef以线程安全方式处理非自有引用unowned references尤其面向 free-threading 构建PyImport_ImportModuleAttr/PyImport_ImportModuleAttrString导入模块并获取其属性的一步到位辅助函数PyUnicode_KIND/PyUnicode_DATA在宏之外新增同名函数实现宏依赖编译器相关的位域布局函数形式对稳定 ABI 更友好。4.2 移除与弃用移除PySequence_Fast从 limited C API 移除其配套宏PySequence_Fast_GET_ITEM在 limited API 中从未生效私有函数_PyInterpreterState_GetConfigCopy/_PyInterpreterState_SetConfig移除改用 PEP 741 的PyConfig_Get/PyConfig_Set私有_Py_InitializeMain()Python 3.8 经 PEP 587 引入的 provisional API移除未公开的_PyTrash_begin/_PyTrash_end移除JIT 内部测试 API 移除批量弃用计划 3.18 移除_PyBytes_Join→PyBytes_Join、_PyDict_GetItemStringWithError→PyDict_GetItemStringRef、_PyDict_Pop→PyDict_Pop、_PyLong_Sign→PyLong_GetSign、_PyLong_FromDigits/_PyLong_New→PyLongWriter_Create、_PyThreadState_UncheckedGet→PyThreadState_GetUnchecked、_PyUnicode_AsString→PyUnicode_AsUTF8、_Py_HashPointer→Py_HashPointer、_Py_fopen_obj→Py_fopen。在 Python 3.13 及更早版本上可通过 pythoncapi-compat 项目获取这些新公开函数线程安全PyGC_Enable()/PyGC_Disable()/PyGC_IsEnabled()在 free-threading 构建下改为原子操作性能decimal模块改用 PEP 757 C API导出/导入整数当Decimal实例的整数部分较小时可提速内部清理移除LLTRACE宏改用Py_DEBUG并修复 lltrace 调试特性可能被错误启用的帧问题。五、测试、工具与构建Tests / Tools / Buildtest.support.reset_code新增测试工具用于重置函数的字节码级优化与本地插桩状态便于测试在优化前后行为一致的场景--parallel-threadsN回归测试运行器新增选项可在多线程中并行运行单个测试以发现并发 bug。注意发布说明的提示大部分测试套件尚未经过线程安全审查或标注thread_unsafe该模式主要用于排查而非默认回归配置BOLT 处理test_embed中在 BOLT instrument 二进制下段错误的用例被禁用仅当启用 BOLT 时生效iOS 测试运行器剥离测试套件每行输出的日志前缀pygettext改用 AST 解析器实现抽取修复多个 bug对应 Tools/i18n/pygettext.pymacOS 安装器ncurses 升级到 6.5ctypes/libffimacOS 使用系统libffi时复数类型支持改为运行时检测macOS 10.15且构建时也需可用构建PGO 训练中移除test_embed其贡献已可忽略修复 Clang 9 及更早版本因缺少__attribute__((fallthrough))支持的编译错误文档构建 Python 文档要求 Sphinx 8.1.3澄清string.printable并非 POSIX 意义上的可打印字符str.isprintable()对其返回FalseIDLE帮助文档改为只复制 idle.html 的文本部分到 idlelib/help.html简化维护。六、升级与验证建议对于计划升级到 3.14.0a5或最终 3.14.0的开发者建议关注以下与自身代码相关的点平台判断若代码解析sys.platform判断 FreeBSD 版本注意其已固定为freebsdC 扩展作者检查是否使用本版本弃用的_Py*私有 API见上文清单尽早迁移到对应的公开 APIlimited C API 用户需确认未使用PySequence_Fast性能敏感路径bytearray.resize适合在需要反复调整缓冲区的场景替代新建对象切片os.readinto适合在高频文件描述符读取场景减少拷贝安全审计涉及 URL 解析、email 折叠、imaplib 连接不受信服务器的代码建议回归测试对应场景。所有上述变更的官方最小复现用例与回归测试均位于 Lib/test 目录如bytearray.resize见 Lib/test/test_bytes.py、immortal 判定见 Lib/test/test_capi/test_immortal.py可在升级后通过python -m test跑相关模块验证本机行为一致性。七、小结CPython 3.14.0a5 是一个架构推进色彩浓厚的里程碑指令集向BINARY_OP收敛、尾调用解释器与 JIT 双线并进、自由线程构建的 GC/容器/异常路径系统性加固同时以按需导入优化掀起一轮标准库导入时间优化浪潮。对普通 Python 用户而言bytearray.resize、os.readinto、pathlib.Path.info、uuid.NIL/MAX等新 API 直接可感知对 C 扩展维护者而言本版本的私有 API 弃用与移除清单是 3.14 迁移的必读材料。【免费下载链接】cpythonThe Python programming language项目地址: https://gitcode.com/GitHub_Trending/cp/cpython创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 CPython 3.14.0a5 版本解读：核心虚拟机重构、自由线程加固与标准库新特性全景
CPython 3.14.0a5 版本解读核心虚拟机重构、自由线程加固与标准库新特性全景【免费下载链接】cpythonThe Python programming language项目地址: https://gitcode.com/GitHub_Trending/cp/cpython本文基于 CPython 官方仓库中的发布记录 Misc/NEWS.d/3.14.0a5.rst系统梳理 CPython 3.14.0a5预计 2025-02-11 发布在字节码虚拟机、自由线程free-threading、C API、安全修复与标准库等维度的全部关键变更。读完本文你将理解该版本中 BINARY_SUBSCR 被 BINARY_OP 取代、尾调用tail-call解释器引入等架构级改动掌握bytearray.resize、os.readinto、pathlib.Path.info、uuid.NIL/MAX、asyncio调用图 API 等新能力的用法并了解一批安全漏洞的修复细节与受影响场景。一、核心虚拟机与内建Core and Builtins变革3.14.0a5 的核心虚拟机改动集中体现了 CPython 在指令集精简、JIT 深化与自由线程正确性三条主线上的推进。1.1 字节码指令集重构BINARY_SUBSCR 合并进 BINARY_OP本版本实施了一项影响深远的指令集改动Replace the opcode BINARY_SUBSCR and its family by BINARY_OP with oparg NB_SUBSCR.将 BINARY_SUBSCR 及其家族指令替换为带 oparg NB_SUBSCR 的 BINARY_OP。这是 gh-issue 100239 系列工作的延续。此前同系列已新增BINARY_OP_EXTEND指令——它从内联缓存inline cache中读取一对函数guard 与特化函数并执行用于在运行时按操作数类型对二元运算做特化派发本版本又Specialize BINARY_OP for bitwise logical operations on compact ints为紧凑整数上的按位逻辑运算新增了特化路径。配合指令集合并CPython 减少了操作码数量把更多二元运算收敛到统一的分发/特化框架中。感兴趣可以在 Include/opcode_ids.h 与 Python/opcode_metadata.py 中查看当前指令 ID 的编排。1.2 新增尾调用解释器最高 30% 的 Python 密集负载加速A new type of interpreter has been added to CPython. This interpreter uses tail calls for its instruction handlers. Preliminary benchmark results suggest 7-11% geometric mean faster on pyperformance (depending on platform), and up to 30% faster on Python-intensive workloads.本版本新增了采用尾调用tail call实现指令处理器的解释器形态。初步基准显示 pyperformance 几何平均提升 7%–11%视平台而定Python 密集负载最高提升约 30%。需要强调两点事实边界其一这是初步基准结果并非最终承诺其二该解释器当前仅在新版编译器如 clang-19上启用其他编译器仍走原有解释器路径。这说明 CPython 正在同时维护多条解释器实现路线经典 switch 解释器、尾调用解释器与实验性 JIT并以编译器能力为门槛做运行时选择。1.3 JIT 与生成器性能Improve JIT performance for generators为生成器改进了 JIT 性能Improve memory layout of JIT traces优化了 JIT trace 的内存布局Diego Russo 提交Collect JIT memory stats using pystatsJIT 内存统计接入pystats便于开发者用-X pystats观测 JIT 内存行为同时移除了实验性 JIT 编译器的部分内部测试 API见 C API 板块。1.4 自由线程free-threading构建的正确性加固自由线程构建--disable-gil在本版本修复/加固了一批并发问题GC 并发化_Py_qsbr_reserve竞态修复PyGC_Enable/PyGC_Disable/PyGC_IsEnabled改为原子操作见 C API 板块free-threaded GC 新增marking phase从已知根如sys模块字典出发标记所有可达对象与分代、增量 GC 不同的设计使其通常每个对象工作量更少、更快GC 预取优化当经历完整回收后仍存活的长生命周期对象数超过阈值时条件启用 CPU prefetch 指令提高缓存命中率、缩短回收时间容器线程安全PyList_Insert、PyList_SetItem在线程安全上被修复hashlib.sha256在 free-threading 下可能产生的多余引用问题被修正异常路径修复了 free-threaded 构建下抛出MemoryError时的竞态条件warnings 模块_warnings_runtime_state.mutex改为递归互斥锁并在更新filters与_filters_version时持锁配合_acquire_lock/_release_lock暴露给 Python 层规避数据竞争此前_release_lock()无锁可释放时的崩溃也已修复。1.5 调试、错误信息与细节行为修正f-string 调试表达式修复f{expr}在表达式含!时显示不完整的问题并将调试表达式按原始字符串raw string处理非法转义序列告警改进SyntaxWarning文案明确说明未来版本将升级为SyntaxError并给出Did you mean \\e?之类的修复建议REPL 体验退出时恢复终端控制字符修复终端 resize 时的报错修复 PyREPL 在os.environ被覆盖为非法值时崩溃修复输入超长行时连续两次 CTRL-Z 导致的_pyrepl崩溃补全菜单改为显示在当前行下方sys.monitoring / sys.settrace处理LINE事件的时间不再随代码对象行数线性增长sys.platformFreeBSD 上不再附带主版本号恒为freebsd而非freebsd13/freebsd14依赖该字符串做平台判断的代码需注意tracebackexcept*包裹裸异常时补上对应帧修复TracebackException._format_syntax_error对带自定义元数据异常的处理生成器帧修复生成器帧存活超过其生成器时访问gi_frame.f_locals崩溃的问题导入路径当前工作目录因权限无法确定时import 不再抛出PermissionError。二、安全修复六个值得关注的问题本版本安全板块覆盖 URL 解析、C API、email、imaplib 等领域urlsplit/urlparse 主机名校验gh-129248 相关安全项修复了主机名解析未拒绝包含方括号[]的域名的问题——按 RFC 3986 Section 3.2.2PySys_AddWarnOptionUnicode 空指针解引用修复了该 C API 在特定输入下可能触发NULL指针解引用的问题email 折叠引号字符串现代 email policy 下折叠跨行的带引号字符串原先会丢失引号与内部转义可能被构造来伪装 header 行若渲染后的邮件被传输或重新解析imaplib 拒绝服务连接恶意服务器时可能分配任意大量内存触及虚拟地址空间上限后引发MemoryError或进程崩溃在所有分配内存都被实际触摸并回落到真实内存的特殊系统/构建上可能耗尽资源syslog.openlog 空指针解引用audit hook 抛异常时触发HTTPResponse.read 负长度修复负读取大小处理错误Patch by Yury Manushkin。三、标准库新增能力按模块速览3.1 容器与基础类型bytearray.resize新增bytearray.resize(n)原地调整缓冲区大小。增大时新区域清零缩小时截断对子类同样生效非法参数抛出TypeError缺参或多参、ValueError负数、MemoryError超内存。完整的参数与边界行为可参考 Lib/test/test_bytes.py 中的test_resize用例os.readinto新增os.readinto(fd, buffer)从文件描述符直接读入 buffer 协议 对象避免中间对象与拷贝。_pyio.FileIO.readinto已改用该函数优化见 Lib/_pyio.pyarray.array修复对已耗尽的迭代器调用setstate崩溃的问题ast.unparse不再在无必要时复用引号类型保证 round-trip 输出更稳定。3.2 asyncio 与并发调用图分析 API新增asyncio.capture_call_graph与asyncio.print_call_graph实现位于 Lib/asyncio/graph.py可捕获当前任务或指定 Future 的异步调用图FutureCallGraph(future, call_stack, awaited_by)结构asyncio.staggered.staggered_race支持上报调用图信息并修复了其泄漏任务与未处理异常的问题eager task 的 name 关键字asyncio.loop.create_task、asyncio.create_task、TaskGroup.create_task对 eager 任务支持name关键字kwargs 会透传给任务工厂loop.set_task_factory设置TaskGroup移除了导致取消丢失的错误优化Barrier修正asyncio.Barrier与threading.Barrier的ValueError消息传输层修复_SelectorTransport在写入完成前被关闭时的异常与不完整写入问题。3.3 文件与路径pathlib.Path.info新增Path.info属性与pathlib.types.PathInfo协议Lib/pathlib/types.py。该对象支持查询文件类型并内部缓存os.stat结果Path.iterdir生成的对象会利用扫描父目录得到的文件类型信息初始化zipfilewritestr尊重SOURCE_DATE_EPOCH环境变量以实现可复现构建ZipFile.open对未压缩、未加密的只读 zip 支持完整随机访问shutilshutil.copy、copy2、copyfile默认使用os.copy_file_range为 btrfs/XFS 提供写时复制COW机会、为 NFS 提供服务端复制机会_pyio.FileIOreadall()采用与_io.FileIO.readall()一致的缓冲分配/增长算法readinto利用os.readinto避免多余对象与拷贝。3.4 网络与协议logging.handlers.SysLogHandler新增 sockettimeout关键字参数SMTPHandler修复secure参数处理imaplib新增 IMAP4IDLE支持RFC 2177 风格的服务器推送等待模式ctypes.util.dllist新增列出当前进程已加载共享库的函数http.cookies支持PartitionedCookie 标志CHIPS 相关。3.5 数据格式与解析uuid.NIL / uuid.MAX新增 NIL00000000-0000-0000-0000-000000000000与 MAXffffffff-ffff-ffff-ffff-ffffffffffff常量对应 RFC 9562sqlite3用户自定义 SQL 函数参数个数非法时改抛sqlite3.ProgrammingError创建函数时处理内存不足修复sqlite3.Row在继承的description为None时可能段错误的问题csv修复写入超过 2GB 数据字段时的整数溢出csv导入时间通过按需导入re最多降低约 5 倍re不再隐式暴露为csv.relocale更新别名映射以匹配最新 X Org locale 别名与 Glibc 2.41 新增 localeconfigparser不再在每次读取时重建未命名 section。3.6 性能优化导入时间与热点路径3.14.0a5 对导入时间做了系统性的按需导入优化gettext导入时间最多降低约 10 倍按需导入rebase64导入时间最多降低约 6 倍不再导入reb16decode性能最多提升约 10 倍更高效地检查十六进制位pstats与zipfile导入时间最多降低约 20%移除多余typing导入subprocess通过惰性导入locale与signal提速threading惰性导入warningstomllib移除typing、string、tomllib._types导入optparse在无需打印帮助文本时减少导入开销。其他热点优化PyLong_FromUnsignedLong/PyLong_FromUnsignedLongLong/PyLong_FromSize_t为中等大小整数新增快速路径列表与元组迭代使用迭代器对象 freelistint去分配器微优化sys._is_immortal新增用于运行时识别 immortal 对象对应 C API 的PyUnstable_IsImmortal。3.7 其他行为变更与弃用颜色输出-E只忽略PYTHON_COLORS而不忽略FORCE_COLOR/NO_COLOR/TERMFORCE_COLOR/NO_COLOR为空字符串时修正行为颜色检测默认改用 stdout 的isattydifflib.HtmlDiff比较页支持暗色模式calendarCLI 高亮移入私有类highlight_day从公开TextCalendarAPI 移除turtle新增turtle.fill、turtle.poly、turtle.no_animation上下文管理器math域错误支持自定义消息math.sqrt、math.log、math.atanh为例pdb弃用pdb.Pdb.curframe_localsinline 模式下退出 pdb 显示确认提示并优雅退出string.Formatter自动编号模式支持属性/项访问如{.name}、{[1]}importlib为DEBUG_BYTECODE_SUFFIXES、OPTIMIZED_BYTECODE_SUFFIXES、WindowsRegistryFinder、ResourceLoader、SourceLoader.path_mtime补上弃用告警sysconfigexpand_makefile_vars弃用改用get_paths(vars...)is_python_build(check_home...)的弃用排期至 3.15并修复expand_makefile_vars的NameErrorcodecsreplace_errors、backslashreplace_errors、xmlcharrefreplace_errors修复UnicodeError.start/end处理warnings_release_lock()无锁可释放时的崩溃修复见上文。四、C API 变更新增、移除与弃用清单4.1 新增公开 APIPyUnstable_IsImmortal判断对象是否为 immortal对应 Python 层sys._is_immortalPyUnstable_TryIncRef与PyUnstable_EnableTryIncRef以线程安全方式处理非自有引用unowned references尤其面向 free-threading 构建PyImport_ImportModuleAttr/PyImport_ImportModuleAttrString导入模块并获取其属性的一步到位辅助函数PyUnicode_KIND/PyUnicode_DATA在宏之外新增同名函数实现宏依赖编译器相关的位域布局函数形式对稳定 ABI 更友好。4.2 移除与弃用移除PySequence_Fast从 limited C API 移除其配套宏PySequence_Fast_GET_ITEM在 limited API 中从未生效私有函数_PyInterpreterState_GetConfigCopy/_PyInterpreterState_SetConfig移除改用 PEP 741 的PyConfig_Get/PyConfig_Set私有_Py_InitializeMain()Python 3.8 经 PEP 587 引入的 provisional API移除未公开的_PyTrash_begin/_PyTrash_end移除JIT 内部测试 API 移除批量弃用计划 3.18 移除_PyBytes_Join→PyBytes_Join、_PyDict_GetItemStringWithError→PyDict_GetItemStringRef、_PyDict_Pop→PyDict_Pop、_PyLong_Sign→PyLong_GetSign、_PyLong_FromDigits/_PyLong_New→PyLongWriter_Create、_PyThreadState_UncheckedGet→PyThreadState_GetUnchecked、_PyUnicode_AsString→PyUnicode_AsUTF8、_Py_HashPointer→Py_HashPointer、_Py_fopen_obj→Py_fopen。在 Python 3.13 及更早版本上可通过 pythoncapi-compat 项目获取这些新公开函数线程安全PyGC_Enable()/PyGC_Disable()/PyGC_IsEnabled()在 free-threading 构建下改为原子操作性能decimal模块改用 PEP 757 C API导出/导入整数当Decimal实例的整数部分较小时可提速内部清理移除LLTRACE宏改用Py_DEBUG并修复 lltrace 调试特性可能被错误启用的帧问题。五、测试、工具与构建Tests / Tools / Buildtest.support.reset_code新增测试工具用于重置函数的字节码级优化与本地插桩状态便于测试在优化前后行为一致的场景--parallel-threadsN回归测试运行器新增选项可在多线程中并行运行单个测试以发现并发 bug。注意发布说明的提示大部分测试套件尚未经过线程安全审查或标注thread_unsafe该模式主要用于排查而非默认回归配置BOLT 处理test_embed中在 BOLT instrument 二进制下段错误的用例被禁用仅当启用 BOLT 时生效iOS 测试运行器剥离测试套件每行输出的日志前缀pygettext改用 AST 解析器实现抽取修复多个 bug对应 Tools/i18n/pygettext.pymacOS 安装器ncurses 升级到 6.5ctypes/libffimacOS 使用系统libffi时复数类型支持改为运行时检测macOS 10.15且构建时也需可用构建PGO 训练中移除test_embed其贡献已可忽略修复 Clang 9 及更早版本因缺少__attribute__((fallthrough))支持的编译错误文档构建 Python 文档要求 Sphinx 8.1.3澄清string.printable并非 POSIX 意义上的可打印字符str.isprintable()对其返回FalseIDLE帮助文档改为只复制 idle.html 的文本部分到 idlelib/help.html简化维护。六、升级与验证建议对于计划升级到 3.14.0a5或最终 3.14.0的开发者建议关注以下与自身代码相关的点平台判断若代码解析sys.platform判断 FreeBSD 版本注意其已固定为freebsdC 扩展作者检查是否使用本版本弃用的_Py*私有 API见上文清单尽早迁移到对应的公开 APIlimited C API 用户需确认未使用PySequence_Fast性能敏感路径bytearray.resize适合在需要反复调整缓冲区的场景替代新建对象切片os.readinto适合在高频文件描述符读取场景减少拷贝安全审计涉及 URL 解析、email 折叠、imaplib 连接不受信服务器的代码建议回归测试对应场景。所有上述变更的官方最小复现用例与回归测试均位于 Lib/test 目录如bytearray.resize见 Lib/test/test_bytes.py、immortal 判定见 Lib/test/test_capi/test_immortal.py可在升级后通过python -m test跑相关模块验证本机行为一致性。七、小结CPython 3.14.0a5 是一个架构推进色彩浓厚的里程碑指令集向BINARY_OP收敛、尾调用解释器与 JIT 双线并进、自由线程构建的 GC/容器/异常路径系统性加固同时以按需导入优化掀起一轮标准库导入时间优化浪潮。对普通 Python 用户而言bytearray.resize、os.readinto、pathlib.Path.info、uuid.NIL/MAX等新 API 直接可感知对 C 扩展维护者而言本版本的私有 API 弃用与移除清单是 3.14 迁移的必读材料。【免费下载链接】cpythonThe Python programming language项目地址: https://gitcode.com/GitHub_Trending/cp/cpython创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考