Composer如何查看包详细信息_Composer包详细信息查看实践

Composer show 命令：别被默认输出骗了，完整信息得这么查

你是不是也遇到过这种情况？想用 composer show 快速查看一个包的详情，结果只返回孤零零的一行版本号，作者、依赖、自动加载配置全都没影儿。

这可不是命令出错了，而是它的默认行为。想看到完整信息，关键在于后面跟的参数。 下面就来拆解几个最实用也最容易用错的场景。

查已安装包的完整元数据：包名写全，再加 -s

直接运行 composer show monolog/monolog，输出大概率只有 monolog/monolog 3.5.0，连描述都没有。想看 autoload 映射、require 列表、主页或作者信息？必须加上 -s 参数（即 --summary）：

• composer show -s monolog/monolog 会展示 autoload 下的 PSR-4 映射（比如 "Monolog\": "src/"），这在调试类找不到的问题时至关重要。
• 如果包根本没安装，命令会明确告诉你 Package monolog/monolog is not installed，不会静默失败。
• 包名必须带上 vendor/ 前缀，composer show monolog 肯定会失败；而且大小写敏感，Monolog/Monolog 也不行。
• 如果你的项目用了 composer install --no-dev，而某个包只在 require-dev 里，那么 composer show 就查不到它。

理清依赖关系：--tree 和 composer depends 各司其职

composer show --tree lara vel/framework 展示的是“谁把它拉进来、它又拉了谁”的向下依赖链，用缩进来表示层级，一目了然：

lara vel/framework v10.48.12
└── symfony/console v6.4.7
    └── psr/log 3.0.0

这能帮你快速定位为什么项目里装了两个不同版本的 psr/log。但要注意，它只显示当前 composer.lock 里已解析并安装的路径，那些被版本约束排除掉的候选版本是不会出现的。

• 如果想反过来查“谁依赖了 psr/log”，得用 composer depends --tree psr/log，而不是 show --tree。
• 输出太长时，可以用 composer show --tree | grep "guzzle" 来过滤，但要小心保留前导空格，否则依赖树的缩进结构就丢失了。
• --tree 不支持通配符，composer show --tree "lara vel/*" 会直接报错。

探索远程包：--all 和 --remote 的实在区别

composer show --all guzzlehttp/guzzle 会实时请求 Packagist API，列出该包所有发布过的版本（包括 dev-main、v7.9.0、3.0.x-dev），非常适合评估升级路径或避开已知的有问题版本。

• --all（注意是两个横线）才是正确参数，-a 是旧版别名，在 Composer 2.2+ 中已被弃用，加了也没效果。
• --remote 只返回 Packagist 上标记为 latest 的那个版本的详情，而不是全部版本；它不能和 --all 同时使用。
• 如果包名拼错了（比如 guzzlehttp/guzle），composer show --all 默认会静默失败，必须加上 -v 参数才能看到 Package not found 的提示。
• 对于未安装的包，composer show 是无法返回 source 或 dist 字段的，这些信息只对本地已安装的包有效。

自动化提取字段：告别 grep，拥抱 --format=json + jq

想批量获取包的许可证、主页或自动加载路径？用 grep 去匹配文本输出很容易翻车——换行、缩进、字段顺序的微小变化都可能让正则表达式失效。

• 更可靠的方法是：composer show --format=json monolog/monolog | jq -r '.homepage'，直接拿到干净的 URL 字符串。
• 查询 PSR-4 映射：composer show --format=json monolog/monolog | jq -r '.autoload["psr-4"]["Monolog\"]'，输出就是 src/。
• --format=json 在 Composer 2.2+ 版本中已稳定支持；旧版本可能会提示 unrecognized option。
• 注意字段名是 require，不是 requires；description 字段通常很短，完整的说明还是得去 GitHub 看 README。

最后，也是最容易被忽略的一点：所有 composer show 命令的查询结果，都严格以 composer.lock 文件为准，而不是 composer.json 里写的版本约束。如果你刚刚修改了 composer.json 但还没执行 update，那么 show 命令显示的仍然是 lock 文件里锁定的旧版本。这一点在排查版本问题时，务必牢记。