Composer用SAT求解器精确计算依赖解，^2.7.4等价于>=2.7.4 <3.0.0（允许升至2.99.999），~2.7.4等价于>=2.7.4 <2.8.0（仅限2.7.x），二者锚点不同、范围相差数量级。

Composer 不会“选一个看起来差不多的版本”，它用 SAT 求解器把所有 require、conflict、platform 配置转成逻辑子句，然后暴力搜索满足全部条件的唯一解——装不上，说明数学上无解。

^ 和 ~ 的边界不是靠猜，是按位截断

写错一个数字位置，允许的版本范围就差一个数量级：

• ^2.7.4 → 等价于 >=2.7.4 <3.0.0：允许升到 2.99.999，只要主版本还是 2
• ~2.7.4 → 等价于 >=2.7.4 <2.8.0：连 2.8.0 都被拦住，只放行 2.7.x
• ~2.7 和 ~2.7.0 行为一致，但后者更明确——Composer 内部自动补 .0，可读性更强
• ^0.8.2 和 ~0.8.2 在 0.x 阶段效果相同（都只允许 0.8.x），但语义不同：^ 表示“守兼容性”，~ 表示“我就要这个次版本”

composer install 秒出，是因为它根本不解题

composer install 只做一件事：逐行校验 composer.lock 里每个包的版本是否仍满足 composer.json 中的约束。O(n) 比对，不触发求解器。

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

• 删了 composer.lock 再 install，等于强制重跑求解器——和 update 一样慢
• composer.lock 不是缓存，是上一次成功求解的完整快照（含 SHA256、源类型、依赖映射）
• CI 流水线若没提交 composer.lock，或被 .gitignore 忽略，每次构建都会得到不可控结果

同一个包被多个依赖提出冲突要求，怎么查

报错 Your requirements could not be resolved 时，别急着改 composer.json，先定位谁在卡脖子：

• 运行 composer why-not vendor/package:version 查哪个包阻止了目标版本
• 运行 composer depends vendor/package 查谁依赖了它，再顺藤摸瓜看它的 require 字段
• 运行 composer show --all vendor/package 确认该包是否真发布了你写的那个 tag（比如写了 ~1.2.3，但它只发了 1.2.2 和 1.3.0，那就永远匹配不到）
• 加 -v 参数跑 composer update，最后一段输出会显示求解器卡在哪条依赖链上

最常被忽略的一点：你写的 ~2.8 看似宽松，实则永久封禁 2.9.0；而 ^2.8 会毫不犹豫升过去——这不是 bug，是你没看清自己锁的是哪一位。