进阶 docs.pypi.org 2026-10-20 06:39:13 · 24 阅读
第2章 撤回包版本 (Yanking)
撤回发布
注 PyPI 目前仅支持撤回整个版本,不支持撤回单个文件。
PyPI 将撤回发布作为删除的非破坏性替代方案加以支持。 所谓被撤回的发布,是指安装工具在通常情况下都会忽略的发布版本,除非它是唯一匹配某个版本限定符(使用 == 或 ===)的版本。 详情请参阅 PEP 592。
我应该在什么时候撤回发布? 和删除一样,撤回发布应谨慎使用,因为它可能会给该包的下游用户带来困扰。 维护者应在以下情况考虑撤回某个版本:
* 该版本已损坏或无法安装。 * 该版本违反了自身的兼容性承诺。例如,如果 sampleproject 1.0.1 无意间与 sampleproject 1.0.0 不兼容,就可以撤回它。 * 该版本包含安全漏洞。
如何撤回发布? 要撤回某个版本,请前往您的项目的版本管理页面: https://pypi.org/manage/project/YOUR-PROJECT/releases/。 点击您想要撤回的版本旁边的 Options 按钮,然后点击 Yank:
此时会弹出一个模态对话框,要求您确认撤回操作,并可选地提供撤回原因:
如果您提供了原因,该原因不仅会显示在版本页面上,还会展示在安装工具所使用的索引 API 中。
提示 强烈建议提供撤回原因,这有助于下游用户判断如何应对该撤回操作。