Skip to content

存储限制

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.

请求增加文件大小限制

笔记

注意：所有提交反馈、报告问题或为 PyPI 做出贡献的用户都应遵守 PSF 行为准则。

如果您因为达到上传文件大小限制而无法将项目版本上传到 PyPI，我们有时可以提高您的限制。请确保您已上传至少一个小于限制的项目版本（开发版本号即可）。然后， 提交一个 issue并告知我们：

  • 你的项目在 PyPI（或 TestPyPI）上的链接
  • 您的版本大小（以兆字节为单位）
  • 您需要提升哪些索引的权重（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.

释放现有项目的存储空间

重要的

删除和撤回是两种不同的操作。撤回版本或文件并不会释放存储空间。

警告

从项目中删除版本和文件是永久性的，没有管理员干预无法撤销。

警告

删除操作可能会对项目的下游依赖项造成很大的破坏，因为它会破坏 已锁定版本的安装。

在执行删除操作之前，我们强烈建议您考虑对下游业务可能造成的影响。

如果项目大小已达上限，可以通过删除旧版本或项目中的单个文件来释放存储空间。具体操作如下：

  1. 导航至项目的发布管理页面：https://pypi.org/manage/project/YOUR-PROJECT/releases/；
  2. 点击Options要删除的版本旁边的按钮；
    • 如果您想删除整个版本，请点击Delete；
    • 如果要从版本中删除单个文件，请单击Manage，然后使用每个文件的Options菜单将其删除。

申请增加项目规模限制

笔记

注意：所有提交反馈、报告问题或为 PyPI 做出贡献的用户都应遵守 PSF 行为准则。

如果您因为达到项目大小限制而无法将项目的发布版本上传到 PyPI，请先删除任何不必要的发布版本或单个文件， 以降低项目的整体大小。

如果无法达到上述目的，我们有时可以提高您的限额。请提交问题并告知我们：

  • 你的项目在 PyPI（或 TestPyPI）上的链接
  • 项目总大小（以 GB 为单位）
  • 请简要描述您的项目，包括需要增加文件大小的原因。