TypeScript中如何定义兼容type与interface的函数对象参数类型？

问题现象 #

我们定义了一个接收Record<string, string | number>类型参数的函数：

const fn = (param: Record<string, string | number>) => {
  console.log(param);
};

• 直接传入符合结构的对象时，运行正常；
• 用type显式定义变量类型后传入，也正常：

type User = {
  id: number;
  name: string;
}

const p: User = { id: 1, name: 'John' };
fn(p); // 无报错

• 但用interface定义变量类型后传入，会触发类型错误：

TS2345: Argument of type 'User' is not assignable to parameter of type 'Record<string, string | number>'
Index signature for type 'string' is missing in type 'User'

对应的代码：

interface User {
  id: number;
  name: string;
}

const p: User = { id: 1, name: 'John' };
fn(p); // 报错

报错原因 #

核心差异在于TypeScript对type和interface的结构兼容性处理逻辑：

• Record<string, string | number>本质是一个带有字符串索引签名的类型，要求所有以字符串为键的属性，其值必须是string | number类型。
• 用type定义的User属于匿名对象类型，TypeScript会进行结构兼容性的隐式校验：只要该类型的所有属性值都符合string | number，就会认为它兼容Record<string, string | number>，无需显式声明索引签名。
• 而interface是具名类型，默认不会自动推断添加索引签名。即使它的所有属性值都符合要求，TypeScript也不会认为它带有索引签名，因此无法赋值给要求索引签名的Record类型。

兼容type和interface的解决方案 #

方案1：给interface添加显式索引签名 #

直接在interface中声明字符串索引签名，让它的结构与Record<string, string | number>完全匹配：

interface User {
  id: number;
  name: string;
  [key: string]: string | number; // 显式添加索引签名
}

方案2：用泛型约束替代Record #

通过泛型约束，让函数接受任意对象类型，只要该对象的所有属性值都属于string | number即可，无需依赖索引签名：

const fn = <T extends { [K in keyof T]: string | number }>(param: T) => {
  console.log(param);
};

这种方式下，不管是type还是interface定义的类型，只要属性值符合要求，都能正常传入。

方案3：让interface继承兼容的基础类型 #

先定义一个与Record<string, string | number>等价的type，再让interface继承它，间接获得索引签名：

type StringNumberRecord = Record<string, string | number>;

interface User extends StringNumberRecord {
  id: number;
  name: string;
}

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