如何解决Object.entries遍历User时的TypeScript类型索引错误？

定义了以下TypeScript类型：

type SomeData = {
  field1?: string;
  field2?: string;
}

interface User {
  name?: string;
  enabled?: boolean;
  someData?: SomeData;
}

interface InitValue {
  name: (string | undefined)[];
  enabled: (boolean | undefined)[];
  someData: (SomeData | undefined)[];
}

对应的变量：

let values: InitValue = {
  name: [],
  enabled: [],
  someData: []
}

const users: User[] = [
  {
    name: 'A',
    enabled: true,
  },
  {
    name: 'B',
    enabled: false,
    someData: {
      field1: 'field1 value'
    }
  }
]

尝试用users填充values时编写了如下代码：

users.forEach((user)=> {
  for (const [key, value] of Object.entries(user)) {
    values[key].push(value)
  }
})

触发TypeScript错误：

Element implicitly has an 'any' type because expression of type 'string' can't be used to index type 'InitValue'.
No index signature with a parameter of type 'string' was found on type 'InitValue'.

由于实际数据包含上百个字段，不想通过switch分支逐个处理，需要解决key和value的类型推导问题。

核心问题是Object.entries(user)返回的键类型为string，TypeScript无法确认该string属于InitValue的合法键集合。以下是几种高效的解决方式：

方法1：类型断言限定键范围 #

直接将Object.entries(user)断言为Array<[keyof User, User[keyof User]]>，明确键是User的合法键，值为对应类型：

users.forEach((user) => {
  for (const [key, value] of Object.entries(user) as Array<[keyof User, User[keyof User]]>) {
    values[key].push(value);
  }
});

这种方式简单直接，适合字段较多的场景，TypeScript会自动校验key的合法性以及value与目标数组元素的类型匹配度。

方法2：封装通用类型安全工具函数 #

如果需要复用此类逻辑，可以编写泛型函数确保类型一致性：

function collectValues<T, K extends keyof T>(target: Record<K, T[K][]>, sources: T[]) {
  sources.forEach(source => {
    (Object.keys(source) as K[]).forEach(key => {
      target[key].push(source[key]);
    });
  });
}

// 调用方式
collectValues(values, users);

通过泛型约束K为T的键，确保target与sources的键完全匹配，同时严格保证值类型对应。

方法3：添加索引签名（不推荐） #

给InitValue添加字符串索引签名可以消除错误，但会丢失类型检查的严谨性，允许任意字符串键：

interface InitValue {
  name: (string | undefined)[];
  enabled: (boolean | undefined)[];
  someData: (SomeData | undefined)[];
  [key: string]: (string | boolean | SomeData | undefined)[];
}

该方式会让TypeScript无法校验非法键的访问，仅适合对类型安全要求较低的场景。

内容的提问来源于stack exchange，提问作者Renaud is Not Bill Gates