TypeScript中接口为何不匹配Record<string, unknown>？如何处理？

为什么接口Bar不匹配Record<string, unknown>？ #

TypeScript中，接口（Interface）和类型别名（Type Alias）在条件类型的extends判断逻辑上存在差异：

• Record<string, unknown>本质是带字符串索引签名的类型，要求目标类型允许任意字符串键的属性存在。
• 你定义的Bar接口是“精确”的结构类型，没有显式声明索引签名——即使它的所有属性都是字符串键，TypeScript也不会自动将其视为匹配Record<string, unknown>。
• 而类型别名Foo是对象字面量类型，在条件类型中会被视为“开放”结构，只要属性键都是字符串类型，就会兼容Record<string, unknown>。

如何修改ToObject以支持接口类型？ #

要让ToObject筛选出所有可被JSON.stringify处理的类型（包括接口、对象类型别名、数组），需要调整判断逻辑：不再依赖带索引签名的Record，而是直接判断是否为对象/数组，同时排除函数、Symbol、BigInt等不可序列化的类型。

修改后的类型定义：

type ToObject<T> = 
  // 匹配数组类型
  T extends unknown[] ? T :
  // 匹配对象类型，排除不可序列化的特殊类型
  T extends object 
    ? T extends Function | symbol | bigint ? never : T
    : never;

测试验证：

type Foo = {
  id: number;
  title: string;
}

interface Bar {
  id: number;
  title: string;
}

type Baz = (a: number) => number;

type A = ToObject<Foo>; // Foo ✅
type B = ToObject<Bar>; // Bar ✅
type C = ToObject<Baz>; // never ✅

如果需要更严格模拟JSON.stringify的行为（比如排除包含函数/Symbol属性的对象），可以进一步递归处理属性类型，但针对当前需求，上面的定义已足够解决接口不匹配的问题。

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