composer browse 不会打开 README,只跳转 Packagist 页面;可靠方式是直接查看 vendor/{vendor}/{name}/README.md。

composer browse 不会打开包的 README 文档,它只打开 Packagist 页面;想看 README,必须进 vendor/ 目录手动查文件。
composer browse 为什么打不开 README
composer browse 命令本质是拼接 https://packagist.org/packages/{vendor}/{name} 并用系统默认浏览器打开。这个页面展示的是元数据聚合页,不是文档站。
- Packagist 页面上的
homepage字段由作者手动填写,常为空、错填或指向 GitHub 主页而非文档(如https://github.com/guzzle/guzzle,而真实文档在https://docs.guzzlephp.org/) - 私有包或未上 Packagist 的包会直接报错:
Could not find package xxx on packagist.org - 该命令不校验链接有效性,也不支持跳过 Packagist 直达文档
怎么快速定位并查看本地 README.md
包安装后,源码已落盘,README.md 就在 vendor/{vendor}/{name}/ 下,路径明确、无需联网、内容最准。
工作流任务拆解与模型编排技能。使用场景:(1) 收到复杂工作任务需要拆解为可执行步骤,(2) 需要为不同步骤选择最合适的模型,(3) 需要跟踪工作流进度和模型使用情况,(4) 长时间任务卡住需要问题诊断和解决方案。
- 确认包名格式:必须带 vendor,如
monolog/monolog,不能只写monolog - 执行
ls -d vendor/monolog/monolog/README*查看是否存在(常见变体:README、readme.md、docs/README.md) - 存在则直接查看:
cat vendor/monolog/monolog/README.md | head -n 30 - 若
.dist.path在composer show --format=json中为空(旧版 Composer 常见),fallback 到固定路径更稳妥
composer show 能否替代 README 查阅
composer show 只输出 composer.json 中的字段快照,不包含完整文档内容;它能帮你拿到 homepage 或 source 地址,但这些字段不可靠,不能作为文档入口依赖。
-
composer show monolog/monolog输出的homepage可能是https://github.com/Seldaek/monolog,需手动点进去再找 README -
composer show -a可能含readme字段,但绝大多数包发布时未嵌入,结果为空 -
source字段通常是 Git 地址,可拼出在线 README 链接(如https://github.com/xxx/yyy/blob/main/README.md),但不如本地文件快且确定
真正可靠的文档入口永远是 vendor/{vendor}/{name}/README.md —— 它随包发布自动落地,不依赖作者维护字段,也不受网络或 Packagist 状态影响。别在 homepage 和 composer browse 上浪费时间翻错页面。

















