composer show --tree 命令以树状结构展示 PHP 项目依赖关系，帮助开发者清晰查看各包的嵌套依赖。顶层节点为项目直接引入的包，缩进子节点表示其依赖的组件，通过 ├── 和 └── 符号体现层级，版本约束如 ^3.0 标明兼容范围。该命令适用于排查依赖冲突、优化项目体积、理解间接依赖及评估升级影响，结合 --dev 或 --no-dev 可切换开发与生产环境视图，是管理复杂项目依赖的实用工具。
当你在使用 Composer 管理 PHP 项目依赖时，经常会遇到依赖包之间相互嵌套的情况。为了更清晰地了解当前项目中安装的包及其依赖结构，composer show --tree 是一个非常实用的命令。它以树状结构展示已安装包的依赖层级关系，帮助开发者快速定位依赖来源和潜在冲突。
命令作用与基本用法
composer show --tree 的主要功能是列出当前项目中所有已安装的依赖包，并以缩进形式展示每个包所依赖的子包，形成一棵清晰的依赖树。
基本语法如下：
composer show --tree你也可以查看某个特定包的依赖树：
composer show --tree vendor/package-name解读依赖树结构
执行该命令后，输出结果类似以下格式：
phpunit/phpunit 9.5.10 ├──phpunit/php-file-iterator ^3.0 ├──phpunit/php-code-coverage ^9.2 │ ├──phpunit/php-token-stream ^4.0 │ └──ext-xdebug * └──phpunit/php-text-template ^2.0
其中：
- 顶层节点：如 phpunit/phpunit，是直接被你的项目 require 的包。
- 子节点（缩进）：表示该包所依赖的其他组件。
- 箭头符号（├──, └──）：表示树形结构中的分支连接。
- 版本约束：如 ^3.0 表示兼容版本范围。
实际应用场景
这个命令在以下几种情况特别有用：
- 排查依赖冲突：当两个包依赖不同版本的同一个库时，可以通过依赖树定位冲突源头。
- 优化项目体积：发现某些大体积包仅因少数功能被引入，可考虑替换或移除。
- 理解包的行为：某些功能可能来自间接依赖，通过树状图能看清完整调用链。
- 升级前评估影响：查看某个底层包被多少上级包依赖，判断升级风险。
结合其他选项增强可读性
你可以搭配其他参数提升信息获取效率：
- --dev：包含开发环境依赖（如 phpunit、phpcs）。
- --no-dev：仅显示生产环境依赖。
- 组合使用：composer show --tree --dev 可查看包含测试工具在内的完整依赖结构。
基本上就这些。熟练使用 composer show --tree 能让你对项目的依赖关系一目了然，是维护复杂 PHP 项目时不可或缺的小工具。
