如何创建兼具动态与静态类型属性的TypeScript对象

问题场景 #

从服务器获取的数据固定包含_id字符串属性，同时存在任意数量的字符串键，对应的值是包含associatedIds数字数组的对象，结构示例：

{
  "_id": "123456",
  "5678" : {
     "associatedIds" : [567, 675, 756]
  },
  "6789" : {
     "associatedIds" : [678, 786, 867]
  }
}

直接定义类型时触发错误：Property '_id' of type 'string' is not assignable to 'string' index type '{ associatedIds: number[]; }'，原错误类型代码：

type Data = {
  _id: string;
  [someId: string] : {
    associatedIds: number[];
  }
}

错误原因 #

TypeScript要求对象的固定属性类型必须匹配索引签名的类型。此处_id是string类型，而索引签名规定所有字符串键的值都必须是{ associatedIds: number[] }类型，二者类型不兼容，因此抛出错误。

解决方案 #

方案1：交叉类型（推荐） #

通过交叉类型将固定属性与索引签名分离定义，规避类型冲突：

type Data = { _id: string } & Record<string, { associatedIds: number[] }>;

Record<string, T>是TypeScript内置工具类型，用于快速定义“键为字符串、值为T类型”的对象，和手动写索引签名效果一致，但更简洁。

方案2：手动交叉索引签名（兼容旧环境） #

若环境不支持Record工具类型，可手动组合交叉类型：

type Data = { _id: string } & { [someId: string]: { associatedIds: number[] } };

方案3：排除固定键的严谨定义 #

如果需要约束动态键不能是_id，可结合Exclude工具类型实现：

type Data = { _id: string } & Record<Exclude<string, '_id'>, { associatedIds: number[] }>;

这种方式能更精准地匹配实际数据结构，避免动态键与固定键重名的情况。

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