返回资讯中心
外部精选
软件工程
#开发者实时流

PyPI 加强对上传分发包的检查,不合规的 sdist 和 wheel 将被拒绝

来源标题:Stricter checks for uploaded distributions on PyPI

PyPI 在过去几个月新增了额外校验,可拒绝不符合规范的源码包(sdist)和构建分发包(wheel)。这是让 Python 打包生态更严格遵循各自规范、减少解析器差异的举措之一,后续还会有更多检查。下游用户不受影响,包维护者若上传失败应改用非 EOL 的 Python 版本及符合标准的构建后端。

Hacker News 最新woodruffw2026/11/18 · 今天13 分钟阅读

以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

过去几个月里,PyPI 增加了一些额外的检查,可以拒绝上传的源码分发包(“sdists”)和构建分发包(“bdists”或“wheels”)。这些检查是一项更大计划的一部分,目的是让 Python 打包生态更能抵抗解析器差异,后续还将增加更多检查,旨在让 PyPI 对分发包的处理不再那么宽松,而是更严格地符合各自的规范。对于下游用户(包使用者)来说,这些变更没有破坏性影响。遇到失败的包维护者应确保使用的是非 EOL 版本的 Python,以及能够生成正确符合打包标准的分发包的构建后端。

Python 打包有两种主要的发行格式:tar 和 ZIP 都不是为 Python 打包中所扮演的角色而设计的1:两者都包含了与 Python 包分发无关的元数据,并且周围环绕着一个解析器生态,这些解析器在解释输入时相当宽松。这种宽松在本地用户场景中通常是正确的,因为用户往往希望从损坏或略有错误的归档中恢复重要数据。然而,在网络场景中,尤其是在打包场景中,这是不正确的:即使单独宽松的实现之间在解析上存在微小差异,也可能导致解析器差异,从而使相同的输入在不同平台、不同工具上提取出不同的结果。原则上,攻击者可以利用这些差异来违反 Python 打包(以及最终用户)所假设的许多属性,包括:对这些属性的违反可能导致用户安装看起来合法但实际上恶意的分发包,即使分发包自身的完整性(例如通过哈希)已经得到确认。

过去几周里,PyPI 已开始拒绝:使用“V7”风格 tar 归档的源码分发包。V7 是一种遗留的、大多未指定的 tar 格式,源自 UNIX V7,Python 自带的 tarfile 模块从未生成过这种格式。包含归档级 ZIP 注释、可能被误解为 ZIP 控制结构的构建分发包。

这些变更建立在 Seth Larson 去年八月专门为减少 ZIP 差异所做工作的基础之上。

如果你是 Python 打包的下游用户:什么也不用做!这些变更不会直接影响你,你已经依赖的任何分发包(通过 pip install 或 uv add)都会继续正常工作。

如果你是包维护者:大概什么也不用做。PyPI 上绝大多数源码分发包不受这些变更影响,因为它们已经符合 pax 要求。如果你是维护者,并且确实遇到了因归档格式原因导致的上传被拒,请查阅 PyPI 的归档文档。随着我们逐步收紧对格式错误或不符合要求的上传的限制,PyPI 将努力保持该页面为最新状态。

对许多维护者来说,修复方法很简单:确保你的分发包(sdists 和 bdists 都是)是用 Python 构建后端构建的,而不是用 tar、zip 或类似工具手动打包归档。流行的构建后端通常既符合分发包格式规范,也符合 PyPI 的额外归档限制。如果你无法摆脱手动打包步骤,请确保手动符合归档要求,即:源码分发包必须是 POSIX pax 风格的 tar 归档。如果你使用 GNU tar,需要传入 --format=pax 来覆盖默认值。构建分发包必须是有效的 ZIP 归档。两种格式都要求其成员使用 UTF-8 编码的文件名。

这是一项持续进行的计划,涉及 Python 生态的多个方面。我们力求将这项工作与 Python 本身(减少 Python 自带 zipfile 和 tarfile 中的差异数量)以及 Python 打包标准(进一步约束并提高分发包规范的精确性)保持一致。今后,PyPI 将继续识别可应用于上传分发包的新限制。我们的目标是找出干扰最小的限制,即那些可以在不破坏(几乎)任何用户的情况下实施限制。归档差异绝大多数利用了归档格式中晦涩或未使用的方面,因此这通常是可行的。短期内,PyPI 将评估以下额外限制:完全拒绝 GNU 风格的 tar 归档。这些已被源码分发包规范禁止,但目前由于维护者有大量使用而仍被允许。参见 #21012 了解我们的初步计划。完全拒绝 ZIP 注释。PyPI 已经拒绝了其中许多形式,但为了兼容那些在归档注释中放入无害消息(如版本号)的 ZIP 编码器,允许了一小部分。参见 #20934 了解我们的初步计划。

在众多其他打包生态中。↩

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →