TypeScript 5.0+如何定义特定字段类型其余为指定类型的接口？

核心方案：交集类型 + 映射类型 #

直接用固定字段接口和排除固定键的索引映射类型做交集，完美规避常规索引签名的类型统一限制。

完整代码示例 #

// 先定义自定义接口
interface MyCustomInterface {
  id: number;
  name: string;
}

// 拆分定义固定字段与通用约束
interface FixedFields {
  fieldCanOnlyBeString: string;
  fieldCanOnlyBeNumber: number;
}

// 合并为目标接口
type TargetInterface = FixedFields & Record<Exclude<string, keyof FixedFields>, MyCustomInterface>;

验证效果 #

// 合法示例：固定字段类型正确，自定义字段符合约束
const validObj: TargetInterface = {
  fieldCanOnlyBeString: "hello",
  fieldCanOnlyBeNumber: 123,
  customField1: { id: 1, name: "test1" },
  customField2: { id: 2, name: "test2" }
};

// 非法示例1：固定字段类型错误 → TS报错
const invalidObj1: TargetInterface = {
  fieldCanOnlyBeString: 123, // 类型不匹配：number无法赋值给string
  fieldCanOnlyBeNumber: 123,
  customField1: { id: 1, name: "test1" }
};

// 非法示例2：自定义字段不符合约束 → TS报错
const invalidObj2: TargetInterface = {
  fieldCanOnlyBeString: "hello",
  fieldCanOnlyBeNumber: 123,
  customField1: { id: "wrong", name: "test1" } // id应为number类型
};

原理说明 #

• FixedFields 明确固定字段的强类型约束；
• Record<Exclude<string, keyof FixedFields>, MyCustomInterface> 表示所有不属于固定字段的字符串键，对应值必须是MyCustomInterface类型；
• 交集类型&将两者合并，既保留固定字段的专属类型，又约束了其他任意字段的类型，完全贴合需求。

简化写法（可选） #

如果不想拆分接口，可直接合并为一行定义：

type TargetInterface = {
  fieldCanOnlyBeString: string;
  fieldCanOnlyBeNumber: number;
} & Record<Exclude<string, "fieldCanOnlyBeString" | "fieldCanOnlyBeNumber">, MyCustomInterface>;

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