为何TypeScript会抛出Foo类型无法赋值给带索引签名对象的错误？

这个错误的核心原因是：TypeScript 中，没有显式声明索引签名的封闭类型（比如你的Foo接口），和带有索引签名的开放类型，语义上是不兼容的。

具体解释 #

你的Foo接口只明确定义了id和name两个固定属性，TypeScript 会将其视为「封闭类型」——意思是这个类型的对象只能拥有这两个属性，不允许存在其他任意字符串键的属性。

而{ [key: string]: unknown }是「开放类型」，它表示这个对象可以有任意数量的字符串键属性，值的类型都属于unknown范畴。

虽然你的foo对象当前的属性完全符合开放类型的约束，但TS的类型检查会从类型定义的语义出发，而不是仅看当前对象的实际属性。因为Foo没有索引签名，TS无法保证未来不会给foo添加不符合索引签名的属性，所以拒绝这种赋值。

你的代码示例 #

// 定义封闭类型Foo
interface Foo {
  id: number;
  name: string;
}

const foo: Foo = { id: 1, name: "test" };

// 接收开放类型参数的函数
function fn(obj: { [key: string]: unknown }) {
  // 函数可能会尝试访问任意字符串键，比如 obj["randomKey"]
}

fn(foo); // 触发类型错误

解决办法 #

有几种方式可以解决这个类型不兼容问题：

• 给Foo添加索引签名
  修改接口，明确允许任意字符串键的属性，让Foo变成开放类型：

  interface Foo {
    id: number;
    name: string;
    [key: string]: unknown; // 添加索引签名
  }
  

  这样Foo就和函数参数的类型完全匹配了。

• 使用类型断言
  如果你确定foo不会有额外属性，可以临时用断言绕开类型检查：

  fn(foo as { [key: string]: unknown });
  

  注意：这种方式会关闭TS对这个赋值的类型校验，后续如果修改Foo添加了不符合的属性，可能会导致运行时问题，谨慎使用。

• 直接使用开放类型定义对象
  如果你不需要封闭类型的约束，可以直接用索引签名的方式定义对象类型：

  const foo: { [key: string]: unknown } = { id: 1, name: "test" };
  // 或者用Record工具类型
  const foo: Record<string, unknown> = { id: 1, name: "test" };
  

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