Composer依赖冲突本质是约束无交集，需先用composer why-not定位冲突源（如guzzlehttp/guzzle），再用composer why追溯依赖链；解决时优先放宽可控包约束或替换废弃包，慎用--with-all-dependencies等高风险命令。
Composer 依赖冲突不是版本号对不上，而是所有约束条件找不到交集——它根本不会“猜”或“妥协”，只做一件事：穷举所有组合，无解就报错。
composer why-not 是你第一个该敲的命令
错误里只写“Conclusion: don’t install laravel/sanctum:^3.0”，但没说谁在拦路。别读报错末尾那句“found x packages with version constraints that differ”，那是结果，不是原因。
直接运行：composer why-not laravel/sanctum:^3.0，它会输出类似：
myapp/myproject dev-main requires guzzlehttp/guzzle (^6.5) laravel/sanctum ^3.0 requires guzzlehttp/guzzle (^7.2)
这就锁定了冲突包是 guzzlehttp/guzzle。再顺藤摸瓜查谁在死守 6.x：composer why guzzlehttp/guzzle，常会暴露某个老旧 SDK、私有包，或 require-dev 里的工具（比如 phpunit/phpunit 拉进的不兼容 symfony/console）。
注意：composer why 查的是已安装版本的依赖链；如果目标包根本没装上，why-not 才是你该用的第一个命令。
composer update vendor/package --with-dependencies 不是“强制升级”，而是最小范围重算
盲目 composer update 容易触发全量重算，SAT 求解器可能卡住 5 分钟以上；删 composer.lock 更是掩盖问题，不是解决。
正确做法是缩小作用域：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 先锁定冲突包，例如
monolog/monolog - 去 Packagist 查哪个版本能同时被上下游接受（如
v2.9.3既满足^2.0又满足>=2.8.0） - 执行
composer update monolog/monolog --with-dependencies，让 Composer 同时考虑它的直接依赖
不加 --with-dependencies，Composer 默认只升父包，子依赖卡在旧版，大概率还是失败。
慎用 --with-all-dependencies：它改的是整棵树，不是单点
composer require laravel/sanctum --with-all-dependencies 的真实作用，是让 Composer 主动重算整个依赖图，尝试升级/降级已有包来满足新约束。
但它不是“跳过冲突”，而是高风险干预：
- 可能把
guzzlehttp/guzzle从 7.x 升到 8.x，导致new GuzzleHttp\Client()运行时报错 - 可能把
symfony/http-foundation从 v5 升到 v6（v6 尚未正式发布，当前为 2026 年 4 月） - 如果项目用了
composer.lock且团队协作，必须提交更新后的 lock 文件，否则别人composer install会失败
它适用于你明确信任新包、且愿意接受关联变更的场景，不适用于生产环境紧急修复。
replace 和 conflict 字段不是提示，是硬性规则
conflict 字段会让 Composer 主动拒绝安装某组合，哪怕你项目里根本没 require 它——只要其他已装包间接拉进来，就会触发。例如一个私有包写了 "conflict": {"laravel/framework": ">=11.0"}，而你项目没装 L11，却仍报冲突，就是因为某个 SDK 或 dev 工具把它带进来了。
replace 则是让 Composer 把一个包当另一个包的“替身”来处理，比如 symfony/polyfill-mbstring 在 replace 里声明替代 ext-mbstring。但必须确保被替代项真能被完全覆盖，否则运行时出错——用 mockery/mockery 去替换 phpunit/phpunit 的 mock 功能？不行，PHPUnit 内部调用路径绕不开自己的实现。
这两个字段只用于强互斥或真实替代场景，别用来“提醒用户注意版本”，那该写文档或 require 约束。
