composer why-not 用于诊断指定包无法安装的原因，如版本锁定、依赖冲突或PHP版本不满足；需严格按 vendor/package 格式书写，不支持省略vendor名或使用等号。
composer why-not 用来查什么
它不是解决冲突的工具，而是诊断工具：当你想装某个包却失败时，composer why-not 告诉你「为什么这个包不能被安装」——比如依赖链里某处锁死了旧版本、某个 require 冲突、或者平台限制（如 PHP 版本不满足）。
常见错误现象：composer require foo/bar 报错后只看到一堆 unsatisfiable constraints，但不知道哪一行配置在拦路；这时候直接上 why-not 比翻 composer.json 和 composer.lock 高效得多。
怎么用 composer why-not 查具体包和版本
语法很简单，但参数顺序和写法容易错：
-
composer why-not vendor/package—— 查当前项目为何不能装该包的最新稳定版 -
composer why-not vendor/package:^2.0—— 查为何不能装指定版本约束（注意用英文冒号+脱字符，不是等号或波浪号） -
composer why-not php:8.2—— 查为何不能满足 PHP 8.2（可用于排查 platform config 冲突）
别漏掉 vendor 名；写成 why-not package 会报错或返回空。也别加引号，除非包名含特殊字符（极少见）。
为什么有时输出“no matching packages”
这不是命令错了，而是 Composer 根本没在已知仓库里找到那个包名——可能因为：
- 拼写错误，比如
guzzlehttp/guzzle写成guzzle/guzzle - 包已被弃用或重命名，例如
monolog/monolog旧版别名已失效 - 你本地配置了私有 repo，但该包不在其中，而 Packagist 上又没有（比如内部包未公开）
- 用了
--no-cache但网络不通，导致无法检索元数据
此时先运行 composer show vendor/package 确认是否存在；若不确定名字，用 composer search keyword 辅助。
跟 composer prohibits 的区别在哪
why-not 是“我想装 A，但为啥不行”，prohibits 是“谁在阻止 A 被装”——后者更底层，会列出所有直接/间接声明冲突的包及其 require 规则。
实操建议：
- 先用
composer why-not vendor/package快速定位主因 - 如果结果太绕（比如嵌套多层 require），再补一句
composer prohibits vendor/package看是哪个依赖在卡脖子 - 注意
prohibits不接受版本约束，只认包名；想查具体版本冲突，还是得靠why-not
两者的输出都依赖 composer.lock 状态；如果刚删过 lock 文件或切了分支，记得先 composer update --dry-run 确保分析基于当前真实依赖图。
真正麻烦的永远不是命令怎么敲，而是 conflict 出现在 dev-dependency 里、或某个包的 replace 规则暗中覆盖了你想要的版本——这种得结合 composer depends --tree 一层层剥开看。
