PyPI不识别project.urls，配置后链接未显示问题求助

原因排查及修复步骤 #

• 修正URL键名格式
  PEP 621规范中，[project.urls]下的键名不需要用引号包裹，尽管构建工具可能兼容带引号的写法，但PyPI解析时可能无法识别。将配置修改为：

  [project.urls]
  Documentation = "https://pysui.readthedocs.io"
  Bug Reports = "https://github.com/FrankC01/pysui/issues"
  

• 确保构建工具支持PEP 621

  • 升级setuptools至61.0.0及以上版本，这是支持PEP 621配置的最低版本：

    pip install --upgrade setuptools
    

  • 使用python -m build命令构建包，而非老旧的setup.py方式，前者对PEP 621配置的支持更完善。

• 清理缓存并重新构建

  • 删除本地的dist目录和*.egg-info目录，避免旧缓存干扰新构建的包。
  • 重新执行python -m build生成全新的包文件。
  • 再次运行twine check dist/*，确保没有与URL相关的警告信息。

• 重新上传并等待页面刷新

  • 上传后PyPI页面可能需要5-10分钟完成内容刷新，请勿立即查看；若长时间未显示，可删除测试版本后重新上传新构建的包。

内容的提问来源于stack exchange，提问作者Frank C.