Python 3.13.5补丁发布：修复关键问题并提升稳定性

引言

2025年6月11日，Python核心团队发布了Python 3.13.5，这是3.13系列的第五个维护更新。此版本并未引入花哨的新语言特性，而是解决了3.13.4中引入的一些紧迫回归问题和错误。版本号中的“.5”表明这是一个纠正性的紧急更新，而非功能驱动的里程碑。

在本文中，我们将探讨3.13.5的发布背景，列出关键修复，回顾3.13系列中的继承变更，并讨论是否以及如何升级。我们还将展望未来Python版本的影响。

3.13.5的发布背景

Python 3.13于2024年10月7日发布，相比3.12引入了多项重要增强，包括改进的交互式shell、实验性支持无全局解释器锁运行以及初步的JIT基础设施。

然而，在发布3.13.4后，维护人员发现了几个严重的回归问题。因此，3.13.5被加速发布以纠正这些问题，避免影响更广泛的用户群体。在发布前的讨论中，注意到Windows扩展模块构建在某些配置下会失败，这促使了紧急行动。

因此，3.13.5是一个“修复”版本——其重点是错误修复和稳定性，而非新功能。尽管如此，它也继承并稳定了3.13早期引入的许多改进。

关键修复与纠正

虽然3.13.5解决了众多小错误，但以下三个纠正措施是加速更新的主要驱动力：

GH-135151 — Windows扩展构建失败 在Windows上的某些构建配置下，编译扩展模块失败。这追溯到pyconfig.h头文件无意中启用了自由线程构建。该补丁恢复了配置宏的正确对齐，确保扩展构建如常成功。

GH-135171 — 生成器表达式TypeError延迟 在3.13.4中，生成器表达式在给定不可迭代对象时不再早期抛出TypeError，而是推迟到首次迭代时。3.13.5恢复了在创建时当输入不可迭代时立即抛出TypeError的先前行为，避免了开发人员在运行时遇到更隐蔽的意外。

GH-135326 — random.getrandbits()对“类整数”类型失效 在3.13.4之前，将“类整数”对象传递给random.getrandbits()是有效的，只要该值可被视为整数。在3.13.4中，此行为被破坏。3.13.5中的修复恢复了对getrandbits()调用中类整数类型的支持。

除了这三个主要修复，该版本还包括一系列其他小错误修复，这些修复被认为足够重要，需要提前回溯而非推迟到下一个维护周期。

3.13系列的广泛增强与底层改进

由于3.13.5是维护版本，它并未引入全新功能，但继承并巩固了使Python 3.13区别于3.12的许多增强。以下是最值得注意的：

改进的交互式REPL体验 Python现在附带了一个功能更强大的交互式解释器，部分灵感来自PyPy。体验包括：

• 多行编辑
• 默认情况下彩色化的提示符、回溯和doctest输出
• 方便的內建命令，如help、quit、exit，无需括号
• “粘贴模式”以便更轻松地粘贴到REPL中

用户可以通过PYTHON_BASIC_REPL环境变量禁用增强的REPL。

实验性自由线程模式 3.13中最雄心勃勃的举措之一是引入了可选模式，使CPython无需全局解释器锁运行。在此模式下，线程可以更自由地并行执行。该模式目前是实验性的，默认未启用。

通过替代构建支持自由线程执行，包含mimalloc内存分配器的修改版本对此很重要，因为它有助于性能并且是自由线程操作所必需的。

原型JIT编译器 3.13中捆绑了一个最小的即时编译器。它默认禁用，被视为实验性功能——其当前的性能提升有限。目标是为未来版本中更积极的优化奠定基础。

更一致的locals()语义 在旧版本中，修改由locals()返回的字典是未定义或不一致的。Python 3.13为该映射提供了明确定义的语义：更改返回的映射可以可靠地影响优化上下文中的局部变量，这有助于调试工具行为更可预测。

标准库改进 3.13标准库中的一些显著变化：

• dbm.sqlite3：使用SQLite的新dbm后端现在是创建新数据库时的默认dbm后端。
• 文档字符串内存优化：自动从文档字符串中去除前导缩进，以减少内存消耗和.pyc文件大小。
• 新的类型特性：
  • 支持类型参数中的默认值
  • typing.TypeIs用于更直观的类型收窄行为
  • TypedDict中“只读”条目的其他注解和类型空间中的弃用装饰器
• 其他模块：argparse现在支持弃用命令行选项、位置参数和子命令。

在操作系统级别，有与Linux定时器文件描述符交互的新函数，扩展了低级操作系统集成能力。

平台与兼容性变更

• 最低macOS版本提升：Python 3.13现在需要macOS 10.13或更新版本。放弃了对旧macOS版本的支持。
• WASI支持：WebAssembly系统接口现在拥有Tier 2支持。同时，Emscripten不再是官方支持的平台。
• 移动平台：iOS和Android过渡到Tier 3支持。
• 根据PEP 594的移除：作为弃用清理的一部分，许多“死电池”模块最终被移除，如cgi、imghdr、pipes、xdrlib、mailcap等。
• 还移除了lib2to3、tkinter.tix、locale.resetlocale()、typing.io和typing.re命名空间等。

这些变更反映了Python的长期目标：清理冗余、现代化API并启用更高性能的执行路径。

安全补丁与已解决的CVE

尽管3.13.5的主要目标是修复回归问题，但它也携带了重要的安全更新——尤其是在文档和其他外围包中。

例如，Fedora python3-docs包更新至3.13.5解决了多个安全漏洞：CVE-2024-12718、CVE-2025-4138、CVE-2025-4330、CVE-2025-4435和CVE-2025-4517。这些漏洞可能不总是导致代码执行，但它们影响对Python文档资产的信任，如果被操纵可能导致泄露或滥用。

鉴于文档通常被视为“只读”，很容易忽视其在安全中的潜在作用。但攻击者可能在解析、渲染或分发文档字符串或相关工具时利用它们。升级到3.13.5确保您不会暴露于已知的文档级漏洞。

升级：指南、风险与最佳实践

考虑到修复和安全补丁，许多项目将受益于升级到3.13.5。但一如既往，需要谨慎。以下是推荐的升级路径和注意事项：

建议的升级步骤

1. 阅读完整的变更日志/差异：检查官方发布说明和变更日志，发现可能影响代码的变更。
2. 在3.13.5下运行测试套件：如果有自动化测试，运行它们并查看哪些失败。特别注意依赖random.getrandbits、生成器表达式或自定义C扩展模块的部分。
3. 检查依赖项：某些第三方包或扩展模块可能需要更新或重新编译。
4. 使用虚拟环境或容器：在部署到生产环境之前，先在隔离环境中测试。
5. 部署后监控日志和警报：升级后，密切关注运行时异常。
6. 回退计划：如果遇到严重问题，准备回退到3.13.4。

潜在风险与陷阱

• 移除的模块或API：如果代码依赖根据PEP 594移除的模块，将需要替代方案或回溯。
• 错误的假设：如果代码期望locals()突变以旧的未定义方式行为，可能需要调整。
• 扩展模块重新编译：在Windows上，针对早期头文件构建的扩展模块可能在重新编译前失败。
• 自由线程模式谨慎使用：如果尝试GIL禁用构建，预期性能异常或线程危险。
• 与旧系统的向后兼容性：某些不再支持的平台可能迫使您在这些上下文中停留在旧Python版本。

通常，由于3.13.5是维护版本，风险低于主要升级。但仍需保持警惕。

3.13.5对Python未来路径的信号

尽管3.13.5是纠正性补丁，但它巩固了Python未来的更广泛趋势。以下是一些推断和期望：

• 对回归问题的更快响应：3.13.5被紧急发布以纠正关键错误，表明核心团队致力于响应性和稳定性。
• 解释器现代化的投资：通过JIT、自由线程模式和改进的REPL等特性，Python正逐步发展其执行引擎生态系统。
• 更精简的标准库：持续移除已弃用的模块和特性表明未来版本将强调更轻量、更可维护的核心。
• 更严格的平台要求：放弃对旧操作系统版本的支持表明Python愿意削减遗留约束以更清晰地前进。
• 类型系统增强：在类型中添加功能显示Python对类型工具方法的演变——这一趋势可能在3.14、3.15及以后版本中继续深化。

总之，3.13.5可能看起来不是一个大跃进，但它为未来更雄心勃勃的创新加强了基础。

结论

Python 3.13.5作为一个及时、专注的维护版本发布。它修补了3.13.4中的关键回归错误，携带了必要的安全更新，并保留了Python 3.13中引入的增强功能。开发人员应认真考虑升级，并采取标准预防措施：彻底测试、检查依赖项并在部署后监控。

此版本也强化了Python的发展轨迹：朝向更精简的标准库、更智能的解释器设计、更好的工具和响应式维护。3.13.5有助于保持3.13系列的稳定和可靠——为未来的任何发展奠定了坚实平台。