Composer依赖冲突本质是多包对同一依赖提出互斥版本要求，需通过报错末尾的Conclusion、Root requirements和Found conflicting requirements定位根因，再用composer why-not、show --tree等命令精准诊断并调整约束。
Composer 依赖冲突不是配置写错了，而是多个包对同一个依赖提出了无法同时满足的版本要求——直接删 vendor 或 composer.lock 只会掩盖问题，甚至让下次冲突更难定位。
看懂报错末尾那几行关键信息
Composer 不会在开头就告诉你“谁错了”，但它会在报错最后明确写出冲突逻辑。重点盯住三段：
-
Conclusion:开头的句子，比如Conclusion: don't install monolog/monolog 2.10.0—— 这是它尝试失败后回溯出的第一个卡点 -
Root requirements：你composer.json里写的原始需求，例如laravel/framework: ^10.0 -
Found conflicting requirements：两个包对同一依赖的互斥声明，例如package-a requires symfony/console ^5.4但package-b requires symfony/console ^6.2
这些不是日志噪音，是唯一指向根因的线索。别跳过，逐字读。
用 composer why-not 定位“谁在拦路”
当你想装某个版本却失败时，直接运行：
composer why-not vendor/package:version
比如：
composer why-not guzzlehttp/guzzle:^7.8
它会列出所有阻止安装的约束来源，例如：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
myapp/myproject dev-main requires php (^8.2)some/sdk v3.1.0 requires php (^7.4)Root composer.json requires guzzlehttp/guzzle ^7.8
这时你就知道：问题不在 Guzzle，而在 some/sdk 和你的 PHP 版本不兼容。如果输出里出现 ext-intl 或 ext-gd，说明缺扩展，用 php -m 验证即可。
别忽略 require-dev 和 conflict 字段
很多冲突藏在开发依赖或硬性排斥里，不会出现在 require 段落：
-
require-dev中的包也参与依赖解析，哪怕你只跑composer install - 有些包在自己的
composer.json里写了"conflict": {"laravel/framework": ">=11"}，这种排斥不会提前警告，只在 resolve 阶段爆错 - 检查
config.platform.php是否和你当前 PHP 版本一致（比如配置了"php": "8.2"，但实际是php -v显示 8.1）
临时绕过 dev 依赖验证可试 composer update --no-dev，快速确认是不是它们拖了后腿。
调整约束前先查清楚“谁真正需要它”
别急着改 composer.json，先搞清依赖链：
-
composer show --tree vendor/package：展开当前已解析成功的依赖树，看谁引入了它 -
composer depends -r vendor/package：列出所有强制要求该包的上游组件，并标出各自声明的约束范围（-r是关键） -
composer show vendor/package x.y.z：查特定版本的require字段，确认它是否真需要你环境里没有的东西
如果发现某包被多个路径层层引入，说明它可能是“中间受害者”，真正要调的是它的上游依赖。改完约束后，优先用 composer update vendor/package 单独更新，避免全量更新引发新问题。
最常被忽略的一点：composer update --dry-run 仍会完整校验所有约束，包括 conflict 和 platform 配置。它不改文件，但结果和真实执行一模一样——这才是它用来验证修改是否可行的价值所在，不是用来“绕过”冲突的。
