TypeScript中能否覆盖内置Report类型？

首先明确：可以覆盖内置的Report类型，但需要遵循TypeScript的类型合并/覆盖规则，不过这种做法存在潜在风险，以下是具体实现方式和注意事项：

方法1：全局类型声明覆盖 #

在项目中创建一个.d.ts文件（例如global.d.ts），在其中重新声明Report类型：

declare global {
  // 若自定义的是接口类型
  interface Report {
    id: string;
    content: string;
    createdAt: Date;
  }

  // 若自定义的是类类型
  declare class Report {
    constructor(id: string, content: string);
    getSummary(): string;
  }
}

export {};

该文件会与TypeScript内置lib.dom.d.ts中的Report类型合并。如果你的声明更具体（比如添加了专属属性/方法），TypeScript会优先使用合并后的类型；若要完全替换，需注意：内置类型为接口时，可通过同名接口声明实现合并；内置类型为类时，可重新声明同名类完成覆盖。

方法2：排除DOM库中的Report类型 #

若想彻底移除内置Report类型，可通过tsconfig.json调整配置，但这种方式较为激进：

• 若项目不需要整个DOM库，修改tsconfig.json的lib字段，移除dom：

{
  "compilerOptions": {
    "lib": ["es2020"]
  }
}

但这会丢失所有DOM相关类型，仅适用于非前端项目。

• 也可通过@typescript-eslint/no-shadow规则添加例外，或临时使用类型断言规避，但这并非长久解决方案。

关键注意事项 #

• 易引发混淆：其他开发者看到Report时，可能误认为是DOM内置类型，增加维护成本。
• 兼容性冲突：若项目同时需要使用DOM原生Report类型（如上报API场景），覆盖后会导致该类型无法正常调用。
• 版本更新风险：后续TypeScript版本迭代可能修改内置Report的定义，导致覆盖代码出现冲突。

综上，最稳妥的方案仍是重命名自定义Report类型（例如改为AppReport、CustomReport），避免与内置类型冲突，降低后续维护风险。

内容的提问来源于stack exchange，提问作者Leo Jiang