composer show vendor/package-name 可直接查看 homepage 字段,但该字段常为空或指向首页而非文档页,需人工验证;最可靠的是检查本地 vendor/vendor-name/package-name/readme.md 或 docs/ 目录。

composer show 能直接查到 homepage 字段
执行 composer show vendor/package-name 就能看到包的 homepage 字段,这是最接近“官方主页”的元数据。必须指定完整包名(如 monolog/monolog),不能只写 monolog;否则会列出所有已安装包,信息混杂难定位。
常见错误是误把 source 或 dist.url 当作文档页——它们只是代码分发地址,比如 https://github.com/guzzle/guzzle 是仓库首页,而真实文档在 https://docs.guzzlephp.org/。
- 若输出里没有
homepage:行,说明作者没填这个字段,别硬找 -
homepage常指向公司官网或 GitHub 主页,未必是文档入口,需肉眼确认是否含/docs/、/guide/或明确写有 “documentation” - 加
-i参数(composer show -i vendor/package-name)可过滤掉 require-dev 中未安装的包,避免报错
composer browse 不等于打开文档页
composer browse 不是 Composer 内置命令,它的行为完全取决于你装了哪个插件,且默认跳转的是 https://packagist.org/packages/{vendor}/{name},不是包自己的文档站。
比如运行 composer browse guzzlehttp/guzzle,打开的是 Packagist 页面,而 Guzzle 官方文档实际在 https://docs.guzzlephp.org/,这个地址既不在 homepage 字段里,也不在 Packagist 页面显眼位置。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论(Discussion)”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性,以及撰写结论。当用户输入以下任一指令时也会自动触发该功能: - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 私有包或未注册到 Packagist 的包会直接报错:
Could not find package xxx on packagist.org - 不同插件对
--homepage、--source等参数支持不一,行为不统一 - 链接有效性不校验,复制前务必人工确认是否为文档页,而非仓库首页或公司主页
真正可靠的文档入口在 vendor 目录里
包安装后,README.md 和 docs/ 目录已经落地到本地 vendor/{vendor}/{name}/,比任何远程字段都准、快、不依赖网络。
先确认包已安装:composer show vendor/package-name 不报错再继续;然后检查常见路径:
-
ls -F vendor/vendor-name/package-name/README*(注意大小写,README.md和readme.md在 Linux/macOS 下是不同文件) ls -d vendor/vendor-name/package-name/docs/- 存在就直接看:
less vendor/vendor-name/package-name/README.md,第一屏往往就有文档链接或快速入门指引
中文镜像不影响 homepage 查询结果
镜像源只影响包下载和元数据同步速度,不影响 composer show 读取本地已安装包的 composer.json 内容。也就是说,无论你用阿里云、清华源还是官方源,homepage 字段值都来自包作者当初提交的 composer.json 快照。
但要注意:如果包很久没更新,本地缓存的 composer.json 可能过期;此时 homepage 字段可能已失效,而 Packagist 页面上的 Documentation 按钮(来自 support.docs 字段)更实时。
- 查 Packagist 页面的
Documentation按钮,需手动访问https://packagist.org/packages/vendor/package-name - 该按钮是否显示,取决于作者是否在
composer.json的support下填了有效的"docs": "https://..." - 镜像配置本身不影响这个流程,但若镜像同步延迟,可能导致
composer show显示的字段比 Packagist 页面旧










