如何在TypeScript中覆盖或扩展第三方库的interfaces和types类型声明

开发者阿泽

2026-9-30

可以在不修改原有类型名称的前提下重定义/扩展第三方库的类型，你当前的操作存在3个核心问题：

存在循环引用问题：你在模块增强代码顶部提前导入了原库的Apple类型重命名为AppleInterface，又在扩展Apple时继承它，形成循环引用，TS会直接忽略这段扩展逻辑。
类型声明规则错误：interface支持同作用域下的同名自动合并，但type别名不支持重复声明，直接重定义Bananas会触发类型冲突判定，不会覆盖原有类型。
声明文件未被TS正确识别：你没有配置tsconfig.json命中你的自定义声明文件，导致TS优先读取了第三方库自带的类型声明。

正确操作步骤

1. 修正`augmentations.d.ts`写法

// 注意顶部不要添加任何import/export语句，避免成为普通模块文件
declare module "some_npm_library" {
  // 同名interface会自动和原库的Apple接口合并，自带原有的color字段
  export interface Apple {
    size: string
  }

  // 直接重定义type别名即可，TS的模块增强逻辑会优先使用你声明的类型
  export type Bananas = number
}

2. 配置`tsconfig.json`确保声明文件被识别

{
  "compilerOptions": {
    // 如果你把声明文件放在了自定义目录，需要把目录加入typeRoots
    "typeRoots": ["node_modules/@types", "./src/types"],
    // 关闭skipLibCheck避免TS跳过自定义声明的校验
    "skipLibCheck": false
  },
  // 将你的声明文件路径加入include数组
  "include": ["src/**/*", "./augmentations.d.ts"]
}