composer不使用拓扑排序，而是用sat求解器全局联合求解依赖约束；闭环如a→b→c→a会被建模为逻辑矛盾直接报错，autoload越界或require-dev反向加载常引发隐式循环，需用composer depends --tree（带--tree参数且项目已有composer.lock）实锤闭环链路。
Composer根本不做拓扑排序
Composer 不会、也不能靠拓扑排序解决循环依赖。它用的是 SAT 求解器，不是图论算法。所谓“多层循环依赖结构”，在 Composer 看来不是 DAG（有向无环图）上的路径问题，而是一组逻辑矛盾：如果 A → B → C → A 形成闭环，SAT 求解器会在建模阶段就把 A、B、C 的版本变量和它们之间的依赖子句一起扔进 CNF 公式里——只要存在满足所有约束的赋值，就装；否则直接报 Your requirements could not be resolved。
常见误解是“只要把依赖拆成三层就能绕过”，但实际中：
- composer update --dry-run -v 末尾反复出现 vendor/a → vendor/b → vendor/c → vendor/a 就是闭环实锤
- 即使 A→B、B→C、C→A 都写在不同层级的 require 里，SAT 仍会全局联合求解，不区分“谁先谁后”
- autoload 里包含 ../src/ 或 ../../lib/ 路径，可能引入隐式依赖链，让看似无关的包在运行时互相加载
为什么手动拆层或加中间包常失效
很多人尝试用“抽一个中间包 D”来破环，结果发现 composer install 还是卡住。根本原因在于：D 包若同时被 A 和 C require，而它又 require 了 A 或 C 的某个接口类，就会形成新闭环 A → D → A 或 C → D → C。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
真正有效的解耦动作必须切断逻辑耦合点：
- 抽出的公共包 D 不能引用 A 或 C 的任何具体实现类，只能定义接口或 value object
- A 和 C 都只 require D 的稳定版本（如 "d/common": "^1.0"），且 D 的 composer.json 中不能出现 replace 或 provide 对 A/C 的声明
- 如果 D 包含自动加载映射指向 A 或 C 的源码路径（比如 "psr-4": {"App\": "../../a/src/"}），等于把 A 的代码塞进 D 的加载范围，运行时仍可能触发类冲突
composer depends --tree 输出怎么看闭环
composer depends 的箭头方向是“被谁依赖”，不是“依赖谁”。输出中出现 myorg/core ← myorg/api ← myorg/core 才算闭环；如果只看到 myorg/core ← myorg/api ← myorg/utils，那只是线性链，不构成循环。
这个命令有两个硬前提：
- 项目必须已成功执行过 composer install（保证 composer.lock 有完整快照）
- 必须带 --tree 参数，否则只显示一级反向依赖，看不到间接路径
- 若报 Package not found，说明该包没进 lock 文件——先 composer clear-cache，删掉 vendor/ 和 composer.lock，再跑 composer update --dry-run -v 观察卡点
隐式循环比显式 require 更难排查
最常被忽略的闭环来源是 autoload-dev 和测试类。例如：
- A 包的 composer.json 里写了 "autoload-dev": {"psr-4": {"Tests\": "tests/"}}，而它的测试类继承了 C 包里的基类
- C 包的 composer.json 又写了 "autoload": {"psr-4": {"App\": "../a/src/"}}，把自己的 autoload 范围扩到了 A 的 src 目录
- 这时即使 require 字段完全干净，运行 phpunit 也会因类加载顺序错乱崩溃
排查这类问题要：
- 检查所有 require-dev 包的 autoload 和 autoload-dev 是否含 ../、../../、src/ 等相对路径
- 运行 composer dump-autoload --no-dev 后测试是否还复现，确认是否 dev-only 问题
- 在 CI 中加入静态分析工具（如 PHPStan + cyclic-dependency-checker），比等 Composer 卡死后再查更早发现问题
