composer why-not 用于定位包版本安装失败原因而非解决冲突；需有 composer.json 和 composer.lock，命令格式为 composer why-not 'vendor/package:version'，输出显示反向依赖链以揭示阻塞源头。
Composer why-not 不是用来“解决”冲突的，而是帮你快速定位「为什么某个包不能安装指定版本」——它不改依赖，只解释阻塞原因。
什么时候该用 why-not？
你执行 composer require vendor/package:2.0.0 报错，提示 Conclusion: don't install vendor/package 2.0.0 或类似「your requirements could not be resolved」，但看不出哪条依赖在拦路——这时候就是 why-not 的典型场景。
- 不是所有报错都适合：如果只是
Package not found或网络超时，why-not没用 - 必须已存在
composer.json且有锁文件（composer.lock），否则它找不到当前约束上下文 - 支持对 package + version 组合查因，比如
phpunit/phpunit:^10.0、laravel/framework:v11.0.0
why-not 的正确调用方式
命令格式固定：composer why-not vendor/package:version，注意冒号后不能有空格，版本号要写全（支持 ^9.5、~8.2.0、v7.4.0 等合法 Composer 版本约束）。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 常见误写：
composer why-not vendor/package 2.0.0（少冒号 → 报错 unrecognized option） - 版本写太模糊会失效：比如只写
composer why-not monolog/monolog:^3可能返回「no problem found」，因为 ^3 兼容现有锁文件；得写具体无法装的版本如^3.5.0 - 若包名含斜杠没加引号，在 shell 中可能被误解析（尤其 Windows 或 zsh），建议统一加单引号：
composer why-not 'doctrine/dbal:4.0.0'
看懂 why-not 输出的关键逻辑
输出结果本质是一条「反向依赖链」：从你要装的版本出发，逐层回溯哪个已装包强制锁死了冲突版本。重点盯住带 requires 和 conflicts 的行。
-
symfony/console v6.4.0 requires php >=8.1.0→ 说明你 PHP 是 8.0，直接拦住整个 v6.4 分支 laravel/framework v10.30.0 conflicts with guzzlehttp/guzzle → 如果你另一个包要求 <code>guzzlehttp/guzzle:^6.5，就和 Laravel 10 冲突- 出现多条
requires链时，优先检查最短路径（离你目标包最近的一条），往往就是主因 - 如果输出里有
root requires，说明是你composer.json顶层写的某条 require 直接禁止了目标版本
配合 show 和 prohibits 交叉验证
why-not 告诉你「谁拦了」，但不告诉你「拦的人自己能不能升级」。这时需要手动查：
- 运行
composer show vendor/package看当前装的是哪个版本、支持哪些 PHP/扩展 - 用
composer prohibits vendor/package:2.0.0（Composer 2.5+）可列出所有明确声明conflicts或require排斥该版本的包，比why-not更直给 - 如果发现拦路包本身已出新版（比如拦路的是
foo/bar:1.2.0，而foo/bar:1.3.0已支持你要的bar/baz:3.0），那就该升级那个拦路包，而不是硬推冲突包
真正卡住的地方，往往是某条间接依赖的 conflicts 声明或 PHP 版本限制，而不是你直接 require 的包 —— 这点容易忽略，得一层层顺下去看。
