composer show vendor/package-name可查看homepage字段，但该字段需包作者显式声明；若缺失，应访问Packagist页面查Documentation按钮，其数据更实时准确且含自动提取的文档链接。
直接执行 composer show vendor/package-name，看输出里有没有 homepage 字段——有，就点进去；没有，别硬猜，换 Packagist 页面查。
为什么 homepage 字段不一定出现
composer show 只显示 composer.json 中显式声明的 homepage，不是所有包都填了这个字段。很多维护者只写了 source 或 dist URL，那只是代码分发地址，和文档无关。
- 用
composer show -s vendor/package-name查完整 JSON 内容，确认是否真没定义homepage - 如果
-s输出里也没有，说明作者没配，不是你命令写错 - 别把
source的 GitHub 地址当成文档页——README.md 是起点，但不等于“官方文档”
Packagist 页面才是最可靠的 fallback
访问 https://www.php.cn/link/5d2e892c81e5fafc51ab0973879563a0，搜索包名，进详情页后优先看右上角的 Documentation 按钮。这个链接由 Packagist 自动从仓库中提取（比如 docs 目录、gh-pages 分支或 support → docs 字段），比本地 composer show 更实时、更完整。
- 有些包把文档托管在 readthedocs.io 或自建域名，Packagist 会识别并展示，
composer show完全看不到 - 如果按钮灰掉或标 “Not found”，说明作者没提供结构化文档入口，这时再手动点进 GitHub/GitLab 看
README.md或docs/目录 - 注意 Packagist 页面顶部显示的 “Last updated” 时间，比本地
installed.json更准，尤其当你很久没composer update时
常见错误：把搜索当定位，跳过验证步骤
很多人用 composer search log 找到 monolog/monolog，立刻 composer show monolog ——结果报错 “Could not find package”。这是因为 show 默认只查已安装包，而 search 是查 Packagist 全库。
- 正确链路是：
composer search 关键词→ 记下完整包名（如monolog/monolog）→ 访问 packagist.org 验证文档入口 → 再决定是否composer require - 不要依赖
composer show不带参数的结果列表去翻找，信息混杂且无homepage - 若项目尚未安装该包，
composer show vendor/package-name必然失败，这不是 bug，是设计如此
真正容易被忽略的是：Packagist 的 Documentation 按钮可能指向一个重定向页，或者需要翻两层才能到底层 API 文档。别看到有链接就以为万事大吉，点开后至少扫一眼是否有类参考、配置示例、版本兼容表格——这些才是判断“是不是你要的官方文档”的硬指标。
