composer show --tree仅展示已安装依赖的真实快照,不标冲突;定位冲突需用composer why-not回溯阻塞链、composer prohibits查禁止原因,或composer update --dry-run -v分析求解过程。

composer show --tree 显示依赖树但不标冲突
直接运行 composer show --tree 只能展开当前已安装的包结构,它不会高亮或提示版本冲突——哪怕 composer install 已经失败并报出 Conclusion: don't install xxx 这类错误。这个命令本质是“快照式展示”,不是“求解式分析”。
真正要定位冲突,得先让 Composer 把约束矛盾暴露出来:
- 删掉
vendor/和composer.lock(确保从干净状态重试) - 运行
composer update --dry-run -v:加-v输出详细推理过程,--dry-run避免实际写入 - 关键看输出末尾的
Root package requires和反复出现的don't install/it is required by链条
用 composer prohibits 定位具体冲突包
composer prohibits 是最接近“查冲突依赖树”的原生命令,但它需要你先猜一个可疑包名。比如你怀疑 monolog/monolog 版本被锁死,就运行:
composer prohibits monolog/monolog:^2.0
它会列出所有阻止该版本安装的直接/间接依赖及其约束条件。常见场景:
- 项目
composer.json中写了"monolog/monolog": "^1.25" - 某个已装包(如
phpunit/phpunit)在require里硬绑了"monolog/monolog": "^1.0" - 另一个包(如
laravel/framework)的require-dev间接拉入了不兼容的symfony/console版本
注意:composer prohibits 不接受通配符,必须指定完整包名+版本约束;如果只写包名(如 composer prohibits monolog/monolog),它默认检查 dev-main,通常无意义。
composer why-not 比 prohibits 更贴近“为什么不能装”
当你已经知道想装哪个版本却失败时,composer why-not 更直接。例如执行 composer require guzzlehttp/guzzle:^7.0 失败后,立刻运行:
composer why-not guzzlehttp/guzzle:7.0
输出会逐层回溯到根依赖,比如:
myapp/myproject - guzzlehttp/guzzle 6.5.5 → requires guzzlehttp/psr7 (^1.4)
some/package - guzzlehttp/psr7 2.0.0 → conflicts with guzzlehttp/psr7 [^1.4]
这比 prohibits 多一层“触发路径”说明,尤其适合调试 require 命令失败的场景。
限制也很明显:它只回答“为什么这个版本不能装”,不回答“哪些包共同导致了这个结果”。如果冲突来自多个包的叠加约束,仍需结合 --dry-run -v 日志交叉比对。
可视化依赖树 + 冲突标记需借助插件
Composer 原生不提供带颜色/符号标注冲突的树状图。可靠方案是装社区插件:
-
composer global require joshdifabio/composer-dependency-graph,然后运行composer dependency-graph --format=png(需 Graphviz) - 更轻量的
composer global require bamarni/composer-bin-plugin,配合composer bin composer-visualize exec -- composer-visualize(部分版本支持冲突高亮)
但要注意:这些插件解析的是 composer.lock 的最终解,而非冲突求解过程本身。当 composer update 卡住时,它们往往无法生成图——因为没 lock 文件可读。
真正难啃的冲突,最后都得回到 composer update --dry-run -v 的日志里,一行行看 Resolving dependencies through SAT 下的否定链条。那个过程没有捷径,也没有图形能替代逻辑推演。











