| 症状 | 循环依赖 / 分层失效 / 共享大杂烩模块 |
|---|---|
| 检测 | 依赖矩阵、变更耦合聚类的对不上 |
| 治理 | 先封新入口，再逐步迁移调用 |
治理节奏示意
治理节奏示意
1. 标记违规包，构建依赖报告
2. 新增代码禁止新违规（门禁）
3. 按调用量与团队优先级分批迁移
4. 违规计数进入周报，趋势下降架构债：依赖缠绕与泥球迹象
架构债的表现：模块间依赖成网（循环依赖）、分层规则名存实亡、公共模块成为垃圾场、变更一触多动；检测靠依赖分析工具与变更耦合分析，治理按边界逐步收口。
易错点
- 一次性大扫除式迁移：风险集中，难以收尾
- 只禁新违规不迁移存量：违规计数恒定，团队渐失动力
数据来源与参考
- 《Working Effectively with Legacy Code》相关讨论；依赖分析工程实践