先运行 composer why-not vendor/package:version 定位冲突源，再用 composer require package:version --no-update 精准干预并 composer update package 重解析，慎用 composer update 全量更新。
composer install 报错 “Conclusion: don’t install xxx v2.3.0” 怎么办
这是 Composer 在依赖解析阶段发现无法同时满足多个包的版本约束时抛出的典型错误。它不是 bug，而是明确告诉你：当前 composer.json 中的约束组合在已知包版本中无解。
常见诱因是某个包（比如 monolog/monolog）被两个不同依赖间接要求了互斥版本：package-a 要求 ^1.25，package-b 要求 ^2.0，而你又没显式声明允许哪个主版本。
- 先运行
composer why-not vendor/package:version（例如composer why-not monolog/monolog:2.3.0），它会列出所有阻止该版本安装的依赖链 - 检查输出中最顶层的“冲突源”——通常是你的直接依赖项，而非深层传递依赖
- 不要急着删
vendor或composer.lock；它们不是问题根源，只是缓存了上一次失败的尝试结果
如何用 require 命令精准降级或锁定一个冲突包
当你确认某个包必须用旧版才能让整个依赖树成立，就得主动干预版本选择。Composer 不会自动“退一步”，得你来指定边界。
比如 laravel/framework 9.x 要求 symfony/console ^6.0，但你的某插件只兼容 ^5.4，这时你可以强制拉取兼容版本：
composer require symfony/console:^5.4 --no-update
注意 --no-update 很关键——它只改 composer.json，不立刻重算依赖，避免中途报错中断。
- 改完后手动运行
composer update symfony/console，让 Composer 仅针对这个包重新解析，缩小影响范围 - 如果仍冲突，说明其他包也强绑了
^6.0；此时要查composer show -t看完整依赖树，定位真正“卡死”的节点 - 慎用
composer update --with-all-dependencies，它可能把一堆次要包也升到不兼容版本
conflict 字段不是摆设：怎么用它提前拦截不兼容组合
conflict 是 composer.json 中被严重低估的字段。它不是用来“提醒”，而是让 Composer 在 install 阶段就拒绝加载已知冲突的组合，避免运行时才爆雷。
例如你写的 SDK 明确不支持 guzzlehttp/guzzle 8.x（因底层接口变更），就在自己包的 composer.json 里写：
"conflict": {
"guzzlehttp/guzzle": "^8.0"
}
这样任何项目试图同时 require 你的 SDK 和 Guzzle 8，Composer 就会在 install 或 update 时直接报错，而不是等代码跑起来才发现 ClientInterface 缺方法。
-
conflict匹配的是已安装的包，不是你当前 require 的目标；所以它对“别人装你包”时最有用 - 别写太宽泛的约束如
"*"，容易误伤；尽量精确到主版本号 - 如果你是应用开发者（非库作者），
conflict用处不大；优先用require+require-dev控制入口
为什么 composer update 不总能解决问题，甚至让冲突更糟
composer update 默认更新所有包到最新满足约束的版本，这在冲突场景下往往适得其反——它可能把一个原本“凑合能用”的旧版升级成彻底打破兼容性的新版。
根本原因是：Composer 的依赖解析器默认倾向“更高版本”，只要满足 require 就会选，不管是否引入新冲突。
- 遇到冲突，第一反应不该是
update，而是why-not+show定位根因 - 如果必须 update，加
--with指定范围，比如composer update foo/bar bar/baz，避免牵连无关包 - 生产环境严禁裸跑
composer update；lock 文件的存在意义，就是防止这种“看似修复、实则埋雷”的行为
最常被忽略的一点：Composer 的冲突提示本身不含上下文时间戳。同一句错误信息，可能源于上周 merge 的 PR 引入的新依赖，也可能源于 Packagist 上某个包昨天悄悄发布了破坏性更新。查 composer.lock 的 diff，比反复重试更有效。
