先看 verbose 输出定位冲突包，再用 composer why-not 分析具体依赖阻断原因，结合 composer show --tree 和 git diff composer.json composer.lock 检查不一致，最后通过 composer update --dry-run 验证解析逻辑。
Composer install 报错 “Your requirements could not be resolved” 怎么快速定位冲突？
这不是网络或权限问题，而是 composer.json 里声明的依赖版本存在逻辑矛盾——比如 A 包要求 monolog/monolog:^2.0，B 包却强制依赖 monolog/monolog:1.25.0，Composer 就无法生成满足双方的依赖树。别急着删 vendor 或改版本号，先看它自己提供的线索。
关键动作：加 -v（verbose）参数重试安装，它会输出具体哪两个包在“打架”：
composer install -v
错误末尾通常带类似这样的提示：
Conclusion: don't install monolog/monolog 2.8.0 ... Root composer.json requires package-a ^1.3, which requires monolog/monolog ^1.23 -> satisfiable by monolog/monolog[1.23.0, ..., 1.27.2].
这说明：你的项目直接要求了 package-a，而它只认 monolog v1，但某个其他依赖（或你手动加的 require）又拉了 v2。
怎么看 composer.json 和 composer.lock 哪里不一致？
composer.lock 是当前实际解析出的依赖快照，composer.json 是你的“愿望清单”。两者不一致时，install 会按 lock 文件装，update 才重新解析——但如果你刚改过 composer.json 又没 run update，lock 文件就可能“过期”，导致 install 失败或行为异常。
- 用
git diff composer.json composer.lock快速检查是否漏 commit lock 文件 - 用
composer show --tree查看当前已安装包的真实依赖层级（需已有 vendor） - 若想跳过 lock、强制按 json 重新解析，运行
composer update --dry-run—— 它不改任何文件，只报错告诉你哪里卡住了
为什么 composer why-not xxx 比瞎猜靠谱？
这是 Composer 内置的诊断命令，专为回答“我为什么不能装这个包？”而生。例如你想装 symfony/console:v6.4，但失败了：
composer why-not symfony/console:6.4
它会返回类似：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
my/project dev-main requires symfony/console (^5.4) laravel/framework v9.52.16 requires symfony/console (^5.4|^6.0)
注意第二行：Laravel v9 其实支持 v6，但你的项目根 require 写死了 ^5.4，优先级更高，直接锁死了升级路径。
常见误操作：
- 在
require-dev里加了一个高版本包，结果它和require里的稳定版冲突（dev 包也会参与全局依赖解析） - 用了
"minimum-stability": "dev"，导致某些包被解析成dev-master，而其他包不兼容该分支 - 自定义 repo 配置中指定了错误的
packages结构，让 Composer 误判了可用版本范围
手动查 composer.lock 的 JSON 结构要注意什么？
它不是纯线性列表，而是嵌套的 packages + packages-dev 数组，每个包对象含 name、version、require（它的依赖）、conflict（它明确拒绝的包）等字段。
真正容易被忽略的是 conflict 字段——很多包在这里硬性排除特定版本，比如 "php": " 或 <code>"guzzlehttp/guzzle": "，而你本地 PHP 是 8.2 或已装了 Guzzle 8，就会静默失败。
排查建议：
- 用
jq '.packages[] | select(.name == "monolog/monolog")' composer.lock快速提取某包完整记录（需装 jq） - 搜索
"conflict"关键字，逐个检查冲突项是否与你环境或其它已装包匹配 - 注意
packages-dev下的包也可能通过 autoloading 或测试代码间接影响主依赖树
依赖冲突的本质不是版本数字大小，而是语义约束的交集为空。越早看清哪个 require 或 conflict 在起作用，就越少走弯路。
