composer why-not 和 prohibits 命令用于诊断包安装失败原因，前者分析指定版本无法安装的依赖冲突，后者反向查找阻止安装的包；例如 composer why-not monolog/monolog 3.0.0 显示 PHP 版本不满足要求，而 composer prohibits symfony/http-foundation:^6.0 揭示 laravel/framework 依赖锁定及 PHP 版本限制；使用时需确认 platform 配置准确，并结合 --with-dependencies、--dry-run 和 composer show 全面排查依赖问题。
当你在使用 Composer 安装或更新 PHP 包时，可能会遇到某些包无法安装的情况。这时候你想知道“为什么这个版本不能被安装”，Composer 提供了 prohibits 和 why-not 命令（实际是 why-not 或 prohibits 子命令）来帮助你分析版本冲突或阻塞原因。
理解 why-not 和 prohibits 的作用
这两个命令本质上是一样的，用于告诉你某个包或某个版本为何不能被安装。它们会检查当前项目中已声明的依赖关系、锁定文件（composer.lock）、以及全局约束，找出阻止目标版本安装的具体原因。
常见使用场景包括：
- 你想升级某个包到特定版本，但 Composer 拒绝安装
- 某个包完全无法引入，提示冲突
- CI/CD 中依赖安装失败，需要本地排查
基本用法：why-not 查看版本阻塞原因
运行以下命令查看为何某个版本无法安装：
composer why-not vendor/package 2.0.0例如：
composer why-not monolog/monolog 3.0.0输出结果会显示类似：
phpunit/phpunit 9.5.0 requires php ^7.3 || ^8.0your-project -> satisfiable by php 7.2
monolog/monolog 3.0.0 requires php >=8.0 -> your php version (7.2) does not satisfy that requirement.
这说明虽然你想安装 monolog/monolog 3.0.0，但它要求 PHP 8.0+，而你的环境或 platform 配置只支持到 7.2。
prohibits：反向查找哪些包阻止了目标包
如果你想查是哪个已安装的包导致某个包无法安装，可以使用：
composer prohibits vendor/package:version例如：
composer prohibits symfony/http-foundation:^6.0输出可能为：
laravel/framework v8.83.27 requires symfony/http-foundation ^5.4 -> satisfiable by symfony/http-foundation[v5.4.0, ..., v5.4.31]symfony/http-foundation 6.0.0 requires php >=8.0.2 -> your php version (7.4.3) does not satisfy that requirement.
这里可以看到两个问题：Laravel 8 锁定了 Symfony 组件在 5.4.x，同时 PHP 版本也不支持 Symfony 6 所需的最低版本。
实用建议和排查技巧
在使用这些命令时，注意以下几点以提高排查效率：
- 确保
composer.json中的config.platform设置准确，避免因虚假平台版本导致误判 - 尝试加上
--with-dependencies查看更完整的依赖链影响 - 如果项目较大，可先运行
composer update --dry-run预览更新行为 - 结合
composer show查看当前已安装包的实际版本 - 注意开发依赖（require-dev）也可能造成冲突
基本上就这些。Composer 的 why-not 和 prohibits 是解决依赖冲突的利器，能快速定位是 PHP 版本、包版本约束还是间接依赖导致的问题。熟练使用它们可以大幅减少“为什么装不上”这类困惑。
