composer why-not 是排查依赖冲突的首要命令，它能精准定位阻塞链（如 guzzlehttp/guzzle 版本无交集），而非盲目修改文件或重装依赖。
composer why-not 是你第一个该敲的命令
报错里只写 Conclusion: don't install laravel/sanctum:^3.0，但没说谁在拦路。别改 composer.json，先问 Composer：运行 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)
这说明冲突不在 laravel/sanctum 本身，而在 guzzlehttp/guzzle 的约束无交集——^6.5 和 ^7.2 没有语义化版本重叠。
-
composer why guzzlehttp/guzzle接着查谁把它锁死在^6.5；常见来源是私有 SDK、require-dev里的phpunit/phpunit或测试工具 -
composer depends guzzlehttp/guzzle只显示“谁用了它”，不体现版本限制，容易误判；真正要查“为什么它被拉进来”，必须用why - 看到
(conflict with vendor/package >=2.0)，说明那个包自己写了conflict字段，Composer 是照章执行，不是误判
别盲目删 vendor 或 composer.lock
删 vendor 或 composer.lock 不是修复，是掩盖问题。它会让下次 composer install 重新触发 SAT 求解器暴力遍历所有组合，尤其在大型项目中可能卡在 Resolving dependencies 超过 5 分钟，且线上行为可能突变。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 如果
composer install报found x packages with version constraints that differ，优先跑composer update --lock：它不装新包，只根据当前composer.json和已安装vendor/重建composer.lock，确保二者逻辑自洽 - 若
composer update --lock也失败，说明冲突在更底层，错误通常指向某个具体包（如symfony/console v6.4.0），此时才需回到why-not定位封杀链 -
composer validate不报错 ≠composer.lock正确；Git 合并冲突后手动修 lock 文件但未验证结构合法性，就可能导致 install 卡在解析阶段
单点更新比全量 update 更安全
想升级 monolog/monolog 到 3.0.0，又不想牵连 phpunit 或 symfony/polyfill，不能跑 composer update，也不能写 composer update "monolog/monolog:^3"（引号 + ^ 会让 Composer 自己找最新兼容版，可能越界）。
- 正确命令是：
composer update monolog/monolog --with-dependencies；--with-dependencies表示只允许升级monolog/monolog所需的最小依赖集（如psr/log），不会波及无关项 - 升级后立刻
git diff composer.lock，确认只有monolog/monolog和它的直系依赖被改；多改一个symfony/polyfill-*都可能埋隐患 - 如果提示 PHP 版本不满足（如
monolog/monolog:3.0.0要PHP >=8.1），那不是命令问题，是环境不匹配——先检查php -v和composer show php
手动锁定中间版本比放宽约束更可控
当两个包一个要求 "monolog/monolog": "^1.25"，另一个要求 "monolog/monolog": "^2.10"，它们语义化版本无交集。与其写 "monolog/monolog": "^1.25 || ^2.10"（等于把兼容性问题拖到运行时报错），不如去 Packagist 查哪个版本被双方都接受。
- 例如
v2.9.3同时出现在 A 包的^2.0和 B 包的>=2.8.0范围里，那就直接写"monolog/monolog": "2.9.3"，再跑composer update monolog/monolog - 优先调整你控制的私有包（如
acme/payment-sdk）的composer.json，而不是主项目；require-dev里的包也参与解析，常是隐形源头 -
--with-all-dependencies不是跳过冲突，而是让 Composer 重算整棵树，主动升级/降级已有包来满足新约束；副作用明显：可能把guzzlehttp/guzzle从 6.x 升到 7.x，也可能把symfony/http-foundation从 v5 升到 v6，newGuzzleHttp\Client()等调用可能直接报错
复杂点在于：冲突不是“装不上”，而是 SAT 求解器穷举完所有组合后明确告诉你无解。你得先让阻塞链显性化，再干预——每一步都得对应到具体包、具体版本、具体约束，少一个环节，问题就还在原地。
