composer why-not vendor/package:version会从根约束倒推阻塞链，首行即真凶；报错“Your requirements could not be resolved”是SAT求解失败，需用why-not定位互斥约束，而非清理缓存。
直接运行 composer why-not vendor/package:version，它会从你 composer.json 的根约束开始，逐层倒推谁锁死了目标版本——最上面一行就是真凶。
报错 “Your requirements could not be resolved” 怎么挖出卡点
这不是网络或缓存问题，是 Composer 在本地用 SAT 算法求解失败，说明多个约束之间存在逻辑矛盾。关键不是看报错末尾的包名，而是定位“谁在提互斥要求”：
- 立刻执行
composer why-not php:8.3（把 8.3 换成你目标 PHP 版本），输出第一行如果是Root package requires php ^7.4，就说明composer.json里手动写的 PHP 约束太窄 - 如果第一行是某个插件，比如
spatie/laravel-backup v8.0.0 requires php ^8.0，但你项目又依赖了只支持 PHP 7.4 的老包，就得查这个插件是否已有兼容新版的 release - 别漏掉
require-dev：phpunit/phpunit常通过sebastian/exporter锁死symfony/console到 5.x，而新框架要 6.x，这种间接冲突必须靠why-not暴露
更新单个包时怎么避免连带崩掉整个依赖树
默认 composer update 会重算全部依赖，极易把稳定子依赖升到不兼容大版本（比如 guzzlehttp/guzzle 从 7.x 升到 8.x，导致 new GuzzleHttp\Client() 报错）：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 写死包名，不加引号、不加波浪号：
composer update monolog/monolog，不是composer update "monolog/monolog:^3" - 必须加
--with-dependencies：它只允许升级该包及其直系依赖，不会碰phpunit这类无关项 - 加
--dry-run预览：composer update monolog/monolog --with-dependencies --dry-run，确认改动范围再执行 - 升级后立刻
git diff composer.lock：如果多了十几个包，说明约束没控住，得回退
删 vendor 和 composer.lock 是不是万能解
不是，但有时必须做——尤其是换镜像、切 PHP 版本或 Git 合并冲突后：
-
composer.lock是“安装契约”，硬编码了每个包的下载地址、SHA256 校验值、PHP 平台要求；换阿里云镜像后不删它，Composer 就会执着去旧地址拉包 - 团队协作中手动缝合
composer.lock冲突标记（如>>>>> HEAD）会导致content-hash不匹配、同包在packages和packages-dev中版本不一致等逻辑错误 - 删之前确认
composer.json已正确合并，然后彻底删除vendor/和composer.lock，再跑composer update --lock重算整棵树 - Windows 下删完仍报
realpath() returned false，很可能是路径含中文或空格，换到C:\work\myapp这类纯英文路径再试
真正难处理的不是报错文字本身，而是那些没写在 composer.json 里的隐式约束：autoload 路径越界、require-dev 里的测试工具反向加载 src、全局安装的包和本地依赖共用同一命名空间……这些不会出现在 why-not 输出里，得靠 composer show --tree | grep 和人工核对 autoload 配置。
