composer一见到循环依赖就直接报错退出，必须通过composer depends --tree定位闭环，再以抽离契约包、运行时解耦或降级为可选依赖三种方式重构实现单向依赖。
Composer一见到循环依赖就直接报错退出
它不尝试绕过、不降级、不忽略，也不提供--force-cycle-break这类开关——报错信息里出现Package a depends on b, which depends on a或cycle detected，就是明确告诉你：依赖图存在逻辑闭环，必须重构代码结构。
这不是 Composer 的 bug，而是它的设计原则：依赖解析必须是 DAG（有向无环图）。一旦检测到 A → B → A 这类路径，SAT 求解器立刻中止，避免陷入死循环。你看到的“卡在 Resolving dependencies”几十秒，其实是求解器在反复回溯同一组包。
怎么确认真是循环依赖，不是版本冲突
关键看错误现象和诊断路径是否匹配：
- 报错里反复出现两个包互相指涉，比如
myorg/core←myorg/api←myorg/core -
composer update --dry-run -v末尾持续输出类似Resolving: myorg/core → myorg/api → myorg/core的回溯链 -
composer depends myorg/core --tree输出中，myorg/core自身出现两次，且中间经过至少一个其他包 - 执行
composer install失败，但提示Root package cannot be installed，且 CPU 占用飙升
注意：composer validate完全没用，它只校验 JSON 格式；composer show默认包含require-dev，会掩盖真实生产依赖路径。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
最常被忽略的隐式循环来源：autoload + require-dev
很多“循环”根本没写在require字段里，而是靠自动加载悄悄打通的。典型场景包括：
- 你的
autoload声明了"psr-4": {"App\": "src/"}，而src/里用了phpunit/phpunit的TestCase类 - 某个
require-dev包（如phpstan/phpstan）在自己的composer.json里写了"autoload": {"psr-4": {"App\": "../src/"}}，把你的src/加进了它的加载路径 - 你的
autoload-dev配置错误地把vendor/下的路径也加进来了，等于告诉 Composer：“我依赖我自己”
验证方法很简单：临时注释掉require-dev下所有非核心工具（phpunit/phpunit、infection/infection、phpstan/phpstan），再跑一次composer update。如果成功了，问题就在这里。
真正有效的破环方式只有三种，没有“跳过”选项
所有靠谱方案都指向一个目标：让依赖方向变成单向。任何删composer.lock、加--ignore-platform-reqs、改minimum-stability的操作，都只是掩盖症状，下次更新照样崩。
-
抽离契约包：新建
myorg/contracts，里面只放接口、DTO、异常类；它的composer.json中"require": {}必须为空；myorg/core和myorg/api都只require "myorg/contracts": "^1.0"，彼此之间彻底删掉require -
运行时解耦：A 不再
new B()或use BSomeClass，而是定义LoggerInterface（放在契约包），B 实现它，A 通过容器获取实例；此时 A 的composer.json里必须删掉对 B 的require -
降级为可选依赖：如果 B 只在 A 的测试中用（比如 Mock 数据），移到
require-dev；如果是增强功能（如导出 Excel），改用suggest字段提示用户手动安装
别用replace或provide去伪装兼容——这会让autoload错乱，运行时反而报Class not found。契约包的autoload必须干净，命名空间不能和业务包重叠，否则dump-autoload会失效。
