用途:定位并消除模块 A 导入 B、B 又(直接或经链条)导入 A 的循环依赖,避免模块在依赖未完全初始化时被加载,从而产生 undefined 值、ReferenceError、构建或测试警告。
主要能力:提供检测、分类、修复、验证、防回归的完整流程。检测工具包括 Node/TS 的 npx madge --circular --extensions ts,tsx,js,jsx src/、Python 的 pydeps src/mypackage --show-cycles、Java 的 jdeps、webpack 的 circular-dependency-plugin 等。将循环分为类型循环、共享常量循环、服务互相依赖、父子混淆、初始化顺序、re-export 循环等类型。
修复技术:A 抽取共享类型到中立叶子模块;B 反转依赖,用事件/回调替代直接调用;C 依赖注入打破父子循环;D 惰性初始化或动态 import;E 修复 barrel 文件自循环,模块内部改用直接相对导入;F 若循环暴露内聚性则合并模块。
验证与防回归:重跑检测器确认无循环;用 console.assert 检查初始化顺序;Jest 用 npx jest --randomize 随机顺序跑测试;webpack 检查 bundle。通过 ESLint import/no-cycle、Python import-linter 及 CI 步骤(如 npx madge --circular ... && echo "No cycles" || exit 1)强制约束。
适用场景:导入时值未定义、仅在某些测试顺序下失败、TS 编译通过但运行时崩溃、类继承 undefined、barrel 文件隐藏循环等。
限制:动态 import 会增加静态分析难度与异步复杂度,应优先结构性修复;中立模块不得反向导入业务模块;Go 编译器直接拒绝循环,Java 循环多为逻辑问题,Spring 循环 Bean 应重构而非用 @Lazy。具体平台与收费信息暂未提供。