Composer如何查看已安装包:从默认行为到完整清单的精准操作

先说一个核心事实:直接运行 composer show,你看到的并非 vendor 目录下的完整全家福,而仅仅是项目顶层依赖的“精简版名单”。 要想拿到实实在在安装在 vendor/ 里的每一个包,必须借助 --tree 或 --installed 这些选项。这其中的区别,恰恰是很多开发者初次接触时感到困惑的地方。
为什么 composer show 的输出和 vendor/ 目录对不上?
道理其实很简单。默认情况下,composer show 命令只读取 composer.lock 文件里的顶级 packages 字段。这意味着,所有被这些顶层包间接拉进来的依赖(例如,symfony/console 所依赖的 psr/log),在默认输出里是“隐身”的。只有你亲手写在 composer.json 的 require 或 require-dev 里的包,才会露面。
所以,当你发现 composer show 只返回寥寥几个包,而 ls vendor/ 却列出一长串目录时,千万别慌。这不是包漏装了,而是命令的默认行为本就如此。
- 执行前,务必确认你处在项目根目录(包含
composer.json和vendor/的那个位置)。 - 确保你已经运行过
composer install或composer update,否则composer.lock或vendor/composer/installed.json可能不存在,命令自然无法获取有效信息。 - 如果你曾经使用
composer install --no-dev安装项目,那么require-dev里列出的包(比如测试用的phpunit/phpunit)将不会出现,哪怕它们依然写在composer.json里。
用 composer show --tree 透视完整的依赖树
这才是看清项目依赖全貌、排查版本冲突的终极武器。命令会以清晰的缩进和箭头,展示出包与包之间的层级关系,例如:
lara vel/framework v10.48.12
└── symfony/console v6.4.7
└── psr/log 3.0.0
需要警惕的是,它的输出严格基于当前的安装状态。也就是说,如果你安装时使用了 --no-dev 选项,那么开发依赖同样不会出现在这棵“树”上。
- 当依赖树很深、终端宽度不足时,长包名可能会被截断。这时可以加上管道命令
| less -S横向滚动查看,或者干脆重定向到文件:composer show --tree > deps.tree。 - 只想快速定位某个包?别手动滚动查找,直接用
grep过滤:composer show --tree | grep "guzzlehttp"。 - 值得注意的是,这个命令并不直接扫描
vendor/目录,它完全依赖composer.lock文件的解析结果。如果锁文件损坏或与实际情况不一致,输出就可能出现偏差。
导出干净列表,方便脚本或运维处理
如果你需要一份格式整洁、每行一个“包名 版本号”的纯文本清单,交给脚本或运维工具处理,那么 --installed --no-ansi 这个组合是最稳妥的选择:
composer show --installed --no-ansi
这个命令强制只输出已安装的包(自动过滤掉 composer.json 里写了但尚未安装的),同时 --no-ansi 会移除所有终端颜色和控制字符,避免重定向到文件时产生乱码。
- 有一个等价的简短写法:
composer show -i --no-ansi(-i就是--installed的缩写)。 - 如果只需要包名,不关心版本,可以借助
awk:composer show --installed --no-ansi | awk '{print $1}'。 - 想要 JSON 格式?
--format=json确实可用,但其嵌套结构解析起来稍显复杂。对于日常查看,更推荐使用--format=plain格式。
精准查询:某个包到底装没装?装的是什么版本?
直接跟上完整的包名即可,注意大小写敏感,且斜杠不能省略:
composer show monolog/monolog
如果命令返回了版本号、描述和依赖项等信息,那就说明这个包已经妥妥地安装好了。如果报错 Package not found,那大概率是没装上,或者它被安装在了全局环境(需要用 composer global show 来查)。
- 包名拼写错误、大小写不对(比如
Monolog/Monolog和monolog/monolog是不同的)都会导致查询失败。 - 想查看更详细的配置,比如自动加载映射或 scripts 钩子?可以加上
-s(即--show-config)选项,不过这个功能在 Composer 2.2+ 版本才提供稳定支持。 - 刚执行完
composer require xxx却查不到包?检查一下命令执行的终端输出末尾,是否有Installing xxx (x.x.x)和Generating autoload files这样的成功提示。安装过程中途被中断,可能导致vendor/目录和installed.json记录不一致。
最后,必须强调一个最容易被忽略的关键点:composer show 系列命令只反映 Composer 自身的安装记录,它并不验证类文件能否被成功加载,也不检查自动加载机制是否真正生效。 当遇到实际的类找不到等运行时问题时,还得结合 composer dump-autoload 和直接检查 vendor/autoload.php 文件内容来进行交叉验证,这才是解决问题的完整思路。
