中心模块

ID: hub_module | 严重程度: 中 (默认)

"中心模块"（Hub Module）是指在依赖图中充当中心点的模块，同时具有高 Fan-in（扇入，很多模块依赖它）和高 Fan-out（扇出，它依赖很多模块），但其内部逻辑相对较少。

为什么这是一种坏味道

中心模块是架构中危险的"单点故障"。因为它们位于许多路径的中心，所以它们变得极其脆弱。对中心模块的微小更改可能会在整个代码库中引发大规模的连锁反应，使得重构变得困难且风险较高。

示例

坏习惯

一个仅仅重新导出或协调许多不相关服务的模块，而且它本身被整个应用程序使用。

// app-hub.ts
import { AuthService } from './auth';
import { ApiService } from './api';
import { LoggerService } from './logger';
import { ConfigService } from './config';
// ... 还有 10 多个导入

export class AppHub {
  constructor(
    public auth: AuthService,
    public api: ApiService,
    public logger: LoggerService
    // ... 还有 10 多个依赖
  ) {}
}

好习惯

将中心分解为特定的、专注的协调器，或在消费者层面使用依赖注入来避免中心化。

// auth-coordinator.ts (专注于认证相关的协调)
import { AuthService } from './auth';
import { SessionStore } from './session';

export class AuthCoordinator {
  constructor(
    private auth: AuthService,
    private session: SessionStore
  ) {}
}

配置

rules:
  hub_module:
    severity: medium
    min_fan_in: 5
    min_fan_out: 5
    max_complexity: 5

ESLint 规则

此检测器可作为 ESLint 规则使用，以便在编辑器中获得实时反馈。

// eslint.config.js
export default [
  {
    rules: {
      '@archlinter/no-hub-modules': 'warn',
    },
  },
];

详见 ESLint 集成 了解设置说明。

如何修复

打破中心！识别通过该中心的不同数据或控制路径，并将它们提取到独立的、更集中的模块中。