进阶 docs.pypi.org 2026-10-20 06:39:13 · 35 阅读

第1章 PyPI 存储限制详解

存储限制

PyPI 对单独上传的文件大小以及项目内所有文件的总大小都设有存储限制。当前默认限制为单文件 100.0 MB,整个项目 10.0 GB。你可以在项目设置页面(https://pypi.org/manage/project/YOUR-PROJECT/settings/)查看项目当前的占用空间和存储限额。

文件大

默认情况下,PyPI 将单个文件大小限制在 100.0 MB。如果尝试上传超过此限制的文件,你将收到如下错误: Uploading sampleproject-1.2.3.tar.gz HTTPError: 400 Client Error: File too large. Limit for project 'sampleproject' is 100 MB.

申请提高文件大

Note: 所有向 PyPI 提交反馈、报告问题或进行贡献的用户都必须遵守 PSF 行为准则。

如果因为触及上传文件大小限制而无法将项目发布上传到 PyPI,我们可以适当提高你的限额。请确保该项目至少已上传过低于限制的一个版本(开发版本号也可以)。然后,提交一个 Issue 并告知我们:

- PyPI(或 TestPyPI)上你项目的链接 - 发布的文件大小(以 MB 为单位) - 需要提高限额的索引(PyPI、TestPyPI 或两者皆是) - 项目的简要描述,包括需要增加空间的原因。

项目大

默认情况下,PyPI 将项目内所有文件的总大小限制在 10.0 GB。如果尝试上传会导致总大小超过此限制的文件,你将收到如下错误: Uploading sampleproject-1.2.3.tar.gz HTTPError: 400 Client Error: Project size too large. Limit for project 'sampleproject' total size is 10 GB.

释放现有项目的存储

Important: 删除(Delete)和撤回(Yank)是两个不同的操作。撤回某个发布或文件并不能释放存储空间。

Warning: 从项目中删除发布或文件是永久性的,且无法在未经管理员介入的情况下恢复。

Warning: 删除操作可能会对你的项目下游依赖造成严重困扰,因为会导致固定版本的安装失效。在执行删除之前,强烈建议你考虑对下游可能造成的影响。

如果触及项目大小限制,可以通过移除旧版本的发布或个别文件来释放存储空间。操作步骤如下:

1. 前往项目的发布管理页面:https://pypi.org/manage/project/YOUR-PROJECT/releases/; 2. 点击你想要删除发布的发布条目旁边的 Options; 3. 如果想删除整个发布,点击 Delete; 4. 如果想删除发布中的单个文件,点击 Manage,然后通过每个文件的 Options 菜单将其删除。

申请提高项目大

Note: 所有向 PyPI 提交反馈、报告问题或进行贡献的用户都必须遵守 PSF 行为准则。

如果因为触及项目大小限制而无法将发布上传到 PyPI,请先移除不必要的发布或单个文件以降低项目总大小。如果无法做到,我们可以适当提高你的限额。提交一个 Issue 并告知我们:

- PyPI(或 TestPyPI)上你项目的链接 - 项目的总大小(以 GB 为单位) - 项目的简要描述,包括需要增加空间的原因。

评论 (0)