能否完全替换外部包的TypeScript接口？寻求更优实现方案

要完全替换外部全局命名空间中的接口（而非扩展），作为临时方案，你可以利用TypeScript的接口合并特性，通过兼容的泛型参数声明来覆盖原接口的定义：

方法1：兼容泛型参数的接口合并 #

由于TypeScript要求同名接口的泛型参数必须一致（包括数量和默认值），你可以给新增的泛型参数设置默认值，确保和原接口兼容，同时在新接口中定义你需要的所有属性：

// 你的全局声明文件（比如global.d.ts）
declare global {
  namespace TheirNamespace {
    // 保留原泛型参数的默认值，新增泛型参数并设默认值never
    interface Foo<GenericType = any, ExtraType extends object = never> {
      // 这里可以添加或覆盖原接口的所有属性
      // 示例：添加自定义属性
      extraField?: ExtraType;
    }
  }
}

// 确保文件被当作模块处理
export {};

效果说明 #

• 原接口为空时，合并后的接口完全等同于你的新定义，实现“替换”效果；
• 原接口有属性时，新接口会和原接口合并，若你重新定义了同名属性，新属性类型会覆盖原类型；
• 所有使用TheirNamespace.Foo的地方（包括智能提示）都会自动识别新增的泛型参数和属性。

方法2：完全替换（需覆盖所有命名空间成员） #

如果你需要彻底忽略原接口的所有定义，可以重新声明整个命名空间，但必须包含原命名空间的所有其他成员（否则会丢失这些成员的类型）：

declare global {
  namespace TheirNamespace {
    // 完全重新定义Foo接口
    interface Foo<GenericType = any, ExtraType extends object = never> {
      // 你的完整接口定义
    }

    // 必须重新声明原命名空间的其他所有成员，比如：
    // interface Bar { /* 原Bar的定义 */ }
    // function doSomething(): void;
  }
}

export {};

注意事项 #

这种方法需要同步原命名空间的所有成员，维护成本较高，仅适合原命名空间成员较少的场景。

为什么你的原写法可行？ #

你之前尝试的代码其实已经满足需求：新增泛型参数并设置默认值后，TypeScript会合并两个接口，由于原接口为空，最终效果就是你的新接口完全替代了原接口。

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