如何通过TypeScript强制文件夹内文件导出指定继承类或同一接口

好的，我来帮你解决这两个TypeScript的强制约束问题——这类需求在大型项目里规范代码结构、保证一致性特别有用：

1. 强制文件夹下所有文件导出继承自指定类的类 #

我们可以利用TypeScript的**模块声明（Module Declarations）**给目标文件夹内的所有文件加上类型约束，具体步骤如下：

步骤1：先定义父类 #

首先确保你有一个作为基类的Class，比如：

// src/BaseClass.ts
export abstract class BaseClass {
  abstract run(): void;
}

步骤2：在目标文件夹添加类型声明文件 #

假设你要约束的文件夹是src/child-classes/，在这个文件夹下创建index.d.ts文件，内容如下：

// src/child-classes/index.d.ts
import { BaseClass } from '../BaseClass';

// 约束文件夹内所有.ts文件的默认导出必须是BaseClass的子类
declare module './*.ts' {
  export default class extends BaseClass {}
}

效果与示例 #

现在src/child-classes/下的每个.ts文件的默认导出都必须是BaseClass的子类，否则TypeScript会直接报错：

• 正确示例：

// src/child-classes/MyClass.ts
import { BaseClass } from '../BaseClass';

export default class MyClass extends BaseClass {
  run(): void {
    console.log('Running');
  }
}

• 错误示例（TypeScript会报错）：

// src/child-classes/BadClass.ts
// 没有继承BaseClass，不符合约束
export default class BadClass {
  doSomething(): void {}
}

扩展：如果用命名导出而非默认导出 #

如果你要求每个文件导出一个特定名称的类（比如ExportedClass），可以修改声明文件：

declare module './*.ts' {
  export class ExportedClass extends BaseClass {}
}

这样每个文件必须导出名为ExportedClass且继承自BaseClass的类。

2. 强制jobs文件夹下所有文件导出同一接口 #

对于jobs/文件夹下的a.ts、b.ts、c.ts，要强制它们都导出同一个接口，同样可以用TypeScript的声明文件实现：

步骤1：创建约束用的声明文件 #

在jobs/文件夹下创建index.d.ts，先定义标准接口，同时约束所有文件必须导出该接口：

// jobs/index.d.ts
// 先定义好我们要求的标准接口
export interface Job {
  jobName: string;
  execute(): Promise<void>;
}

// 约束文件夹内每个.ts文件必须导出这个Job接口
declare module './*.ts' {
  export { Job };
}

效果与合规写法 #

现在jobs/下的每个.ts文件都必须导出Job接口，有两种合规的写法：

1. 直接实现并导出接口：

// jobs/a.ts
export interface Job {
  jobName: string;
  execute(): Promise<void>;
}

2. 重新导出声明文件中的接口：

// jobs/b.ts
export { Job } from './index';

如果某个文件没有导出Job接口（或者导出的接口结构不匹配），TypeScript会立刻抛出错误，确保所有文件都遵循规范。

注意事项 #

• 确保你的tsconfig.json中包含了这些声明文件（通常include数组包含**/*.d.ts即可）；
• 如果文件夹内有.tsx文件，需要把声明中的通配符改成*.tsx，或者用**/*.(ts|tsx)覆盖所有文件类型。

内容的提问来源于stack exchange，提问作者Alexander Mills