唯一可靠命令是composer show --tree,它基于vendor/和composer.lock输出真实依赖快照,非composer.json理想状态;查未安装包用--remote,反向依赖用composer show --who,溯源必须加--tree,且依赖树不等同代码调用关系。

直接结论:别用 composer tree,它不是内置命令;查真实依赖树唯一可靠方式是 composer show --tree,但必须配合 --no-dev 或 --tree 参数才能看清源头和层级。
为什么 composer show --tree 看起来乱、嵌套深、根本没法读
这不是你操作错,是它默认输出所有已安装包(含 require-dev),且不截断深度。一个 Laravel 项目跑出来可能有 20+ 层缩进,终端一屏刷不完。
- 加
--no-dev再执行:composer install --no-dev && composer show --tree,排除测试工具干扰 - 导出到文件后用编辑器搜索:
composer show --tree > deps.txt,再 Ctrl+F 查关键包名 - 别信“
head -n 100截断”——依赖链可能在第 103 行才出现,真要截断得用awk或写小脚本按缩进层级过滤 - 注意末尾带
[dev]的行:说明该包来自require-dev,运行时不会加载,但会污染依赖树判断
composer why 查不到原因?一定是漏了 --tree
composer why vendor/package 默认只返回一级依赖,比如你装了 monolog/monolog,它只显示 laravel/framework,但你真正想确认的是:“我自己的 composer.json 里有没有显式 require 它?”
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 必须加
--tree:composer why --tree monolog/monolog,输出末尾出现your-project-name dev-main才算定位到根 - 如果中断在某个包名后没继续(例如停在
spatie/laravel-ignition就没了),大概率是那个包用了"provide": {"psr/log-implementation": "*"}声明虚拟包,composer why不穿透 provide 关系 - 想查谁间接拉入了某包,用
composer depends vendor/package,但需先启用:composer config experimental.show-depends true
本地路径包调试时依赖树突然断裂?检查 repositories 配置是否完整
用 "type": "path" 引入本地包后,composer show --tree 却看不到它的子依赖(比如你的本地包 require 了 symfony/console,但 show --tree 里没出现),问题几乎一定出在元数据缺失。
- Satis 或私有仓库常见问题:只导出了
name/version/dist,但漏了require字段,Composer 就认为“这个包不依赖任何东西” - 本地路径包本身没问题,但它的
composer.json若没声明"autoload"或"require",Composer 无法解析其依赖图 - 验证方法:进本地包目录执行
composer validate,确保无警告;再手动cat composer.json | jq '.require'确认字段存在且非空 - 临时绕过:在主项目
composer.json的require里也显式加上该包的子依赖(不推荐,仅用于快速验证)
依赖树对不上实际类加载行为?重点看 autoload 注册顺序
两个包都声明了 MyLib\Helper,composer show --tree 显示 A 在上、B 在下,但运行时却是 B 的类生效——这跟依赖树无关,是自动加载器注册顺序决定的。
- PSR-4 映射按
composer.json中autoload和autoload-dev的声明顺序注册,先声明的优先级高 - 运行时执行
echo json_encode(spl_autoload_functions());,看哪个 loader 在前,就能知道谁覆盖谁 - 生成优化 autoload:
composer dump-autoload -o会把所有类转成classmap,此时加载顺序固定,且classmap优先于 PSR-4,可用来验证是否真被覆盖 - 最隐蔽的坑:某些包在
autoload.files里直接require了 PHP 文件,这类代码在 autoload 阶段就执行,不走命名空间查找逻辑
依赖树只是静态快照,它不反映运行时类加载路径、不体现 provide 逻辑、也不保证 PSR-4 映射实际生效顺序。真正卡住的问题,往往藏在 spl_autoload_functions() 输出里,而不是树形图中。

















