composer why-not 可快速定位无法安装某包版本的原因，如依赖冲突、PHP 版本不满足或缺少扩展，通过分析输出可升级依赖、调整环境或安装扩展来解决问题。
什么是 composer why-not
composer why-not 命令用于分析为何某个包的特定版本无法被当前项目安装。它会检查依赖关系树，找出阻止该版本安装的限制条件，比如其他包的版本约束、PHP 版本要求或扩展依赖等。
例如：
composer why-not vendor/package 2.0.0
这条命令会告诉你：为什么 vendor/package 的 2.0.0 版本不能被安装。
常见输出信息解读
执行 why-not 后，Composer 会返回类似以下内容：
- package-a/b 1.2.0 requires vendor/package ^1.0
- your project requires php ^7.4 but vendor/package 2.0.0 requires php >=8.0
- vendor/package 2.0.0 requires ext-gd * but it is not present
这些信息说明了三种典型冲突：
- 其他包显式限制了依赖版本范围
- PHP 版本不满足新版本要求
- 缺少必要的 PHP 扩展
如何利用 why-not 解决问题
根据输出结果，你可以采取以下措施：
- 升级或放宽依赖包版本（如先升级 package-a/b 到支持 vendor/package 2.0 的版本）
- 升级 PHP 环境以满足新版本需求
- 安装缺失的 PHP 扩展
- 检查 composer.json 中是否有手动锁定的版本约束
实用技巧
可以结合其他命令一起使用：
- composer prohibits：功能更强大，显示所有阻止某版本安装的原因（Composer 2.1+）
- composer update --dry-run vendor/package：模拟更新，查看潜在冲突
- 使用 composer show 查看包的可用版本和依赖要求
基本上就这些。composer why-not 虽小，但在排查依赖问题时非常高效，关键是看懂它的输出，并顺藤摸瓜解决根本限制。
