如何重写TypeScript第三方包中的LDFlagSet接口

要完全替换第三方模块中LDFlagSet的定义（移除任意字符串索引签名，仅保留指定属性），核心思路是通过自定义类型声明文件重新声明目标模块，覆盖原有接口——因为TypeScript的接口合并规则是叠加属性，无法直接移除原有接口的索引签名，必须通过重新声明模块来完全替换目标接口。

方法一：精简重定义（适合仅关注核心接口的场景） #

创建一个自定义类型声明文件（比如custom-typings.d.ts），直接重新声明LDFlagSet和依赖它的LDProps，同时保留原模块其他必要类型（如LDClient）：

// custom-typings.d.ts
declare module 'module-name' {
  // 保留原模块中LDClient的定义（按需复制原模块的核心方法/属性）
  export interface LDClient {
    identify(user: unknown): Promise<void>;
    variation(flagKey: string, defaultValue: unknown): unknown;
    // 补充原模块中LDClient的其他方法
  }

  // 自定义LDFlagSet，仅包含指定属性，无索引签名
  export interface LDFlagSet {
    param1: boolean;
  }

  // 重新定义LDProps，绑定新的LDFlagSet类型
  export interface LDProps {
    flags?: LDFlagSet;
    ldClient?: LDClient;
  }

  // 如果原模块还有其他导出（如初始化函数），需在此补充声明
  // export const init: (config: unknown) => LDClient;
}

方法二：基于原模块扩展（适合原模块导出较多的场景） #

如果原模块有大量导出内容，可先导入原模块的所有类型，再针对性替换LDFlagSet，避免重复声明所有内容：

// custom-typings.d.ts
declare module 'module-name' {
  // 导入原模块的所有类型
  import * as OriginalModule from 'module-name';

  // 自定义LDFlagSet，仅保留指定属性
  export interface LDFlagSet {
    param1: boolean;
  }

  // 复用原模块的LDClient类型
  export type LDClient = OriginalModule.LDClient;

  // 重新定义LDProps，替换flags的类型为自定义LDFlagSet
  export interface LDProps extends Omit<OriginalModule.LDProps, 'flags'> {
    flags?: LDFlagSet;
  }

  // 重新导出原模块的其他核心导出（如初始化函数、常量）
  export const init: typeof OriginalModule.init;
}

注意事项 #

1. 确保自定义类型声明文件被包含在tsconfig.json的include数组中（默认.d.ts文件会被自动识别）；
2. 自定义后的LDFlagSet不再包含字符串索引签名，TypeScript会严格检查属性，仅允许param1，拒绝任意其他字符串键。

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