首页/开发/代码质量与评审速查/架构约束检查(依赖方向)
规范与静态检查65 条

架构约束检查(依赖方向)

用工具固化分层依赖:dependency-cruiser、ArchUnit、import-linter 等可声明允许的依赖方向并断言违规,把架构图变成 CI 里可执行的检查。

场景分层依赖 / 循环依赖 / 模块边界
工具dependency-cruiser、ArchUnit、import-linter
时机CI 与本地并行执行

示例(import-linter)

示例(import-linter)
[importlinter:contract:layers]
name = layered
type = layers
layers =
    api
    service
    repository
检查规则从架构决策记录(ADR)来:图形约定落为断言,评审有客观依据。

易错点

  • 规则与现状差距过大:一次性全量告警,先圈定新代码范围
  • 只画图不落工具:架构约束停留在文档,无人执行

数据来源与参考

  • import-linter 文档、ArchUnit 文档、dependency-cruiser 文档
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌