如何在自定义类型声明文件中重写node_modules的接口属性？

要修改第三方库接口的已有属性类型，不能直接在模块扩展中重写（会触发类型冲突报错），也不能递归引用正在声明的接口（导致"recursively references itself"错误）。以下是可行的解决方案：

正确实现步骤 #

1. 导入原模块类型并别名：避免递归引用正在声明的接口，先把原模块的目标接口导入并取别名。
2. 构造修改后的类型：用Omit移除要重写的属性，再通过交叉类型重新定义该属性并添加新属性。
3. 扩展模块替换原接口：让原模块的接口继承修改后的类型，完成属性重写。

完整示例代码 #

自定义声明文件 src/types/example.d.ts

// 导入原模块的Instance接口，并用别名区分
import { Instance as OriginalInstance } from 'example-module';

// 自定义你需要的类型
type CustomType = string[];

// 生成修改后的类型：移除原clients属性，替换为自定义类型，同时新增test属性
type ModifiedInstance = Omit<OriginalInstance, 'clients'> & {
  clients: CustomType;
  test: number;
};

// 扩展第三方模块，让原Instance接口继承修改后的类型
declare module 'example-module' {
  export interface Instance extends ModifiedInstance {}
}

业务代码 src/main.ts

import example from 'example-module';

example.test; // 类型为number，符合预期
example.clients; // 类型为string[]（即CustomType），成功覆盖原类型

为什么之前的方法失效 #

• 直接重写属性报错：TypeScript的模块扩展机制默认禁止修改已有属性的类型，必须通过Omit移除后重新定义的方式绕过检查。
• 递归引用错误：你之前的代码中CustomInstance继承的是正在声明的Instance接口，而非原模块的原始类型，改用别名导入原类型即可避免递归。

注意事项 #

• 确保tsconfig.json的include配置包含你的声明文件目录，比如"include": ["src/**/*"]。
• CustomType需要提前定义或从其他文件导入，保证类型有效。

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