Composer 遇到真实依赖环（如 A→B→A）时直接拒绝解析，错误明确提示 cycle 及路径；破环须结构干预：抽离 contracts、用 replace 切断或清理 require-dev 中的反向 autoload。
Composer 安装基础依赖时出现循环引用，不是配置问题，也不是网络或权限问题，而是依赖图里真实存在 A → B → A 这类闭环——它不会尝试“解开”，直接拒绝解析。
看懂 composer install 报出的循环引用错误
真正触发循环引用时，错误信息会明确带 cycle 和具体包路径，例如：Dependency resolution failed because of a cycle: myapp/core → myapp/api → myapp/core。这不是版本冲突（could not be resolved）或扩展缺失（requires ext-xxx），而是求解器在构建有向图时发现了环。
- 只在
composer install（无composer.lock）或composer update时暴露；已有 lock 文件可能掩盖问题 - 如果错误中出现
dev-main或dev-master，说明你用了不稳定约束，更容易触发环 - 运行
composer depends --tree vendor/package-name可反查谁拉入了该包，辅助定位闭环路径
用 composer update --dry-run -v 确认闭环位置
这个命令不改任何文件，但完整走一遍依赖解析流程。关键不是开头报错，而是盯最后 5–10 行输出：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 反复出现同一组路径（如
vendor/a → vendor/b → vendor/a）就是强信号 - 某个包名连续出现 ≥3 次，且父级不同（如
myapp/core ← myapp/api ← myapp/utils ← myapp/core），说明是多跳环 - 看到
Rejecting vendor/b because it requires vendor/a ^2.0, but currently locked to 1.9，说明版本约束在环内互相拉扯
破环必须结构干预，没有“跳过”选项
Composer 不提供 --force-cycle 或 --ignore-cycle。所谓“降级”“删 lock 重装”只是重跑失败逻辑，问题仍在。真正有效的解法只有三种：
- 抽离
contracts包：新建myapp/contracts，只放接口、DTO、简单 trait；让myapp/core和myapp/api都require "myapp/contracts": "^1.0"，不再互相 require 实现 - 用
replace主动切断：若myapp/core已内置myapp/plugin-sdk功能，就在其composer.json中写"replace": { "myapp/plugin-sdk": "*" }，安装时跳过该包 - 检查
require-dev中的 autoload：80% 的隐式循环来自 phpunit/phpunit 或 infection/infection 的"autoload": {"psr-4": {"App\": "../src/"}}—— 它们把你的代码反向加载进测试上下文，等于“自己依赖自己”
最容易被忽略的是 require-dev 里的 autoload 路径和 composer.lock 是否有效——如果 composer depends --tree 报 Package not found，说明锁文件已损坏，得先删 composer.lock 和 vendor/，再跑 composer update --dry-run -v 看第一步失败点。
