TypeScript接口无法扩展联合类型？原因与解决方案解析

TypeScript的接口扩展机制有明确限制：接口只能扩展对象类型，或者由对象类型组成的交叉类型，联合类型不在允许范围内。

基础示例验证 #

先看你给出的简化代码：

interface Foo {
  a: string
}
interface Bar {
  b: string
}
type Baz = Foo | Bar; // 联合类型

当尝试用接口Qux扩展Baz时：

interface Qux extends Baz { // 报错
  // An interface can only extend an object type or 
  // intersection of object types with statically known members.
  c: string;
}

报错的核心原因是：联合类型是多个不同对象结构的集合，TypeScript无法确定接口需要继承的静态成员到底是Foo的a，还是Bar的b，或是两者的组合，因此拒绝执行扩展操作。

Material UI场景的具体原因 #

你遇到的PaletteColorOptions是SimplePaletteColorOptions与ColorPartial的联合类型，直接用接口扩展它时：

• TypeScript无法解析联合类型的统一结构，因此只会识别你新增的属性，不会继承联合类型中两个子类型的成员
• 而显式扩展SimplePaletteColorOptions和ColorPartial时，相当于让接口扩展这两个对象类型的交叉类型（接口支持同时扩展多个对象类型，TS会自动合并为交叉类型），这符合接口扩展的规则，因此能成功继承所有成员。

总结 #

• 接口扩展要求被扩展的类型是静态可确定的单一对象结构，联合类型是多结构的集合，无法满足这个要求
• 若要覆盖联合类型中的所有子类型，显式列出每个对象类型作为扩展目标是可行的解决方案

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