You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何配置使pip show显示Summary、Home-Page等元数据字段?

问题解决:pip show字段为空的配置修正

针对你遇到的pip show中Summary、Home-Page、Author、License字段为空的问题,结合你的pyproject.toml配置,给出以下修正方案:

1. Summary(摘要)

你已通过移除dynamic中的description并显式声明解决此问题,确认配置如下:

[project]
# 移除dynamic里的"description",添加显式描述
description = "你的项目简短摘要"  # 替换为实际项目描述

如果希望从README自动提取摘要,可保持dynamic = ["description"]并确保Hatchling版本≥1.10.0(该版本优化了README提取逻辑)。

2. Home-Page

旧版pip(如22.1.2)对PEP 621的URL配置映射支持不完善,需确保Hatchling正确将Home地址映射到旧元数据字段。检查配置格式是否正确:

[project.urls]
Home = "你的项目主页地址"

若仍不显示,建议升级pip至23.0+(新版pip对PEP 621元数据支持更完善)。

3. Author

pip show的Author字段对应旧元数据格式,而PEP 621使用authors列表形式。Hatchling需将列表中的作者名称拼接为单个字符串,若当前版本未自动处理,可升级Hatchling至≥1.8.0版本(该版本优化了作者字段的映射逻辑)。同时确保authors配置格式正确:

[project]
authors = [
  {name = "Wolfgang Fahl", email = "wf@bitplan.com"},
  {name = "Tim Holzheim", email = "tim.holzheim@rwth-aachen.de"}
]

4. License

PEP 621中license字段若使用SPDX标识符,需确保Hatchling将其映射到旧元数据的License字段。若当前配置license = "Apache-2.0"不生效,可改为对象格式:

[project]
license = {text = "Apache-2.0"}

同时升级Hatchling至≥1.7.0版本,该版本修复了License字段的打包问题。

完整修正后的关键片段

[project]
name = "py-3rdparty-mediawiki"
description = "Python第三方MediaWiki工具库"  # 显式摘要
authors = [
  {name = "Wolfgang Fahl", email = "wf@bitplan.com"},
  {name = "Tim Holzheim", email = "tim.holzheim@rwth-aachen.de"}
]
license = {text = "Apache-2.0"}
dynamic = ["version"]  # 移除"description"
# ... 其余配置保持不变

[project.urls]
Home = "你的项目主页地址"
# ... 其余URL保持不变

额外建议

  • 升级Hatchling到最新稳定版:pip install --upgrade hatchling
  • 升级pip到最新版:pip install --upgrade pip
  • 重新构建并安装包:hatch build && pip install dist/*.whl

内容的提问来源于stack exchange,提问作者Wolfgang Fahl

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.30 04:55:16