composer依赖冲突本质是约束无交集解，需用composer why-not精准定位封杀链，而非删vendor或强制跳过；它逐层列出阻止指定版本的包及约束，如package-a锁定^1.0、package-b冲突>=2.0，且require-dev全程参与解析。
Composer 依赖冲突不是“安装失败”，而是 SAT 求解器明确告诉你：当前所有约束条件没有交集解——它已经穷举过所有可能，找不到一组版本能同时满足 require、conflict、replace 和平台要求。别急着删 vendor 或强制跳过校验，先让求解器把“谁在封杀哪个版本”说清楚。
composer why-not 是定位冲突链的唯一可靠入口
报错里出现 Conclusion: don't install monolog/monolog 2.9.0，不代表这个版本不能用，只说明它被某个或多个约束联合拦截了。此时 composer why-not monolog/monolog:2.9.0 会逐层列出所有阻止该版本安装的包及其约束条件，例如：
-
package-a 1.2.0 requires monolog/monolog ^1.0（硬性锁定下界） -
package-b 3.4.1 conflicts with monolog/monolog >=2.0.0（显式冲突声明） -
root requires php ^7.4，而monolog/monolog 2.9.0已弃用 PHP 7.4 支持
注意：composer depends 只显示“谁依赖它”，不体现版本限制；composer prohibits 才是真正告诉你“谁不让装”。两者语义完全不同，别混用。
锁文件冲突 ≠ 依赖冲突，但常被误操作放大
合并分支后 composer.lock 出现 git 冲突标记（），这不是 Composer 报错，而是文本合并失败。直接保留一方再跑 <code>composer install 很可能复现依赖冲突——因为旧 lock 文件里的版本组合已被破坏。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 正确做法是运行
composer update --lock：它会基于当前composer.json重新生成 lock 文件，清掉冲突标记并更新哈希值 - 若仍报错，说明问题不在 lock 文件本身，而在
composer.json的约束矛盾，需回到why-not流程 - 切勿手动编辑
composer.lock中的content-hash或packages列表——这会让 Composer 失去一致性校验能力
版本约束写法直接决定求解器能否找到解
冲突本质是多个约束区间无交集。比如一个包要求 "monolog/monolog": "^1.25"，另一个要求 "monolog/monolog": "^2.10"，语义化版本规则下它们没有重叠（1.x 和 2.x 是主版本断裂）。这时：
- 查 Packagist 上是否存在跨主版本兼容的中间版本（如
2.9.3同时被两个依赖接受） - 临时改写为精确版本：
"monolog/monolog": "2.9.3"，再执行composer update monolog/monolog，避免牵连其他包 - 慎用
"^1.25 || ^2.10"：这等于告诉 Composer “两个区间都可选”，但它无法验证你的代码是否真能同时适配两套 API，运行时仍可能崩 - 私有包中滥用
conflict字段（如"conflict": {"laravel/framework": ">=11.0"}）会导致全局拦截——哪怕你项目没装 L11，只要某个已装包间接拉入了 L11 的任何组件，就会触发
SAT 求解器卡住时，不是网络或磁盘慢，是逻辑复杂度爆炸
当 composer update 卡在 Resolving dependencies 超过 3 分钟，日志反复出现 Trying + 回退，说明求解器正在暴力搜索解空间。常见于：
- 项目含 30+ 包，且大量使用
conflict或replace -
minimum-stability设为dev，导致候选版本数量指数级增长 - 存在循环替换或模糊约束（如
*或dev-master）
此时应：
- 先跑
composer update --dry-run -v，看最后几行反复尝试的包名，锁定关键瓶颈点 - 用
composer update vendorA/pkgA --with-dependencies缩小子图范围，每次只动一条路径 - 临时移除
conflict字段仅用于诊断（完事立刻还原），或把minimum-stability改成stable快速出解——但这只是诊断手段，不能留着上线
最易被忽略的一点：require-dev 里的包全程参与依赖解析。哪怕你只执行 composer install，phpunit/phpunit 的 PHP 版本要求也会和主项目冲突。排查时永远要带上 --no-dev 对比一次，确认是不是测试工具链在捣鬼。
