composer依赖冲突本质是多个包对同一依赖提出互斥版本要求，需用composer why-not定位阻断链、show --tree查真实路径、--no-dev排除开发依赖干扰，并聚焦报错末尾的“because”矛盾行。
报 conflict 不是包有问题，而是多个依赖对同一个包提出了无法同时满足的版本要求——直接删 composer.lock 或 vendor/ 只会让问题更难复现。
看懂报错末尾那句 “because A requires B ^2.0, but C requires B ^1.25”
Composer 不会笼统说“冲突了”，它会在日志最后几行明确写出矛盾双方。这一句就是真实冲突点，不是推测。
- 重点盯住反复出现的包名，比如
symfony/console、monolog/monolog、phpunit/phpunit，它们大概率是枢纽包 - 忽略中间堆栈和“Resolving dependencies”过程，直接翻到最后 10 行，那里才是结论段
- 如果看到
your-project-name出现在冲突路径里，说明是你自己composer.json里写了互斥约束（比如同时 require 了两个不兼容的 Laravel 扩展） -
^2.0和~2.0.0范围不同：^2.0允许所有 2.x 版本，~2.0.0只允许 2.0.x，后者更容易和其他约束无交集
用 composer why-not 定位“谁在拦路”
这是最常被跳过的命令，但它能精准指出阻断链路。必须带完整包名和版本号，例如 composer why-not monolog/monolog:^2.0。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 输出中若出现
your-project-name，说明是你自己的composer.json里写了冲突约束 - 输出为空？那不是冲突，可能是 Packagist 镜像未同步，或该版本根本不存在于当前稳定通道
- 别用
composer why替代——它只查已安装版本的依赖来源，不回答“为什么不能装” - 注意：该命令要求 Composer ≥ 2.2；低于该版本会报
Command "why-not" is not defined，此时改用composer prohibits vendor/package或composer update --dry-run -v
用 composer show --tree 揭露间接依赖链
很多冲突藏在第二、三层依赖里。你没写 symfony/console，但 guzzlehttp/guzzle 依赖它，而 phpunit/phpunit 又对它有不同要求——这种嵌套关系只能靠树状展开看清。
-
composer show --tree vendor/package展示该包及其所有上游依赖和锁定版本 - 注意每行末尾的
(locked to X.Y.Z)，表示该版本已被composer.lock固定，删 lock 才可能松动 - 配合
grep快速过滤：例如composer show --tree monolog/monolog | grep "symfony/.*console" - 如果某包在树里出现多次且版本不一致（如
symfony/console v5.4.33和v6.4.7），说明有包用了replace或conflict声明，得去对应包的composer.json查
确认是不是 require-dev 拖了后腿
开发依赖默认参与依赖解析，哪怕你部署时加了 --no-dev，它仍会影响 composer require 或 composer update 的求解结果。
- 先加
--no-dev重试：例如composer update --no-dev，能快速确认是否是require-dev引入的冲突包（比如barryvdh/laravel-debugbar或orchestra/testbench） - 检查
require-dev中是否有与主项目不兼容的包，例如主项目用laravel/framework: ^10.0，就别让orchestra/testbench: ^7.0进来（它内部硬绑 Laravel 9） -
conflict字段不参与 solver 计算，只起提示作用；真正起作用的是require和require-dev中的版本约束 - 如果发现某包声明了
"conflict": {"laravel/framework": "10.*"}但你仍装上了，这不违法，只是作者在说“我测试过不兼容”，你得自己担风险
真正难的不是找到冲突点，而是判断哪个约束该松、哪个该锁——有时候一个 ^ 改成 ~ 就卡死，有时候把宽泛约束换成具体小版本（如 "monolog/monolog": "2.9.3"）反而最稳。别迷信“升到最新”，交集版本往往藏在中间。
