如何修改PyPI项目名称以纠正大小写错误?
修正PyPI项目名称大小写错误的方法
首先要明确:PyPI的项目名称是大小写不敏感的,但无法直接修改已注册的项目名称,哪怕只是大小写差异。你需要通过以下步骤完成迁移:
- 注册正确的项目名称(比如你要的
project):确认该名称未被占用后,用twine或PyPI官网提交一个最小占位包(可以是空包,或包含迁移提示的版本)。 - 更新原错误名称的项目(比如
Project):在最新版本的setup.py或pyproject.toml的long_description中添加清晰的迁移说明,告知用户项目已迁移至project;也可以在包的核心代码中加入运行时提示,引导用户安装正确的包。 - 标记原项目为废弃:登录PyPI官网进入原项目页面,通过「Manage」选项将项目设置为「Deprecated」,让用户搜索时能看到废弃提示。
- 同步外部资源:如果有文档、GitHub仓库等外部链接,全部更新为正确的项目名称。
- 申请删除原项目(可选):若原项目无活跃用户,可联系PyPI支持团队申请删除,但需提供合理理由,这一步并非必需。
注意事项:
- 提交正确名称的占位包时,版本号建议从
0.0.1开始,避免与原项目版本混淆。 - 原项目的废弃提示需直白明确,防止用户继续安装错误名称的包。
内容的提问来源于stack exchange,提问作者vauhochzett
相关产品推荐
相关产品推荐

