TypeScript 遍历 Object.keys 后读取属性时报 TS7053

对象的字段明确存在，遍历键名再读取值时，却提示字符串不能索引该类型：

const data = {
  name: "demo",
  role: "reader",
};

const lines = Object.keys(data).map(
  (key: string) => `${key}: ${data[key]}`,
);

在启用 noImplicitAny 的项目里，这类代码会触发 TS7053，诊断通常包含 Element implicitly has an 'any' type。本文针对内置 Object.keys 声明和固定字段的普通对象，TypeScript 5.9.3 与 7.0.2 的相关标准库声明均将键名返回为 string[]。

string 比实际字段名的范围更大

这个对象的已知键只有 "name" 和 "role"，但 key: string 也允许 "missing"。对象类型没有承诺任意字符串都能读取，因此编译器不能按这个宽泛类型索引它。

删掉回调参数上的 : string 仍不足以解决问题，因为 Object.keys 本身返回的就是字符串数组。接下来的改法取决于业务是否接受动态键名。

只读取固定字段时，直接约束键列表

如果界面只需要明确的一组字段，可以让列表里的每个键接受类型检查：

const data = {
  name: "demo",
  role: "reader",
};

const keys: Array<keyof typeof data> = ["name", "role"];
const lines = keys.map((key) => `${key}: ${data[key]}`);

keyof typeof data 在这里表示已知键的联合类型。列表中如果误写了不存在的字段，错误会出现在键列表定义处。这个方案也明确了输出顺序，但新增对象字段不会自动加入列表；是否需要列出它，应由调用方决定。

只需要键和值时，使用 Object.entries

对于示例中值都是字符串的对象，可以直接遍历键值对，不再用宽泛的字符串回头索引：

const data = {
  name: "demo",
  role: "reader",
};

const lines = Object.entries(data).map(
  ([key, value]) => `${key}: ${value}`,
);

这里需要项目的类型库包含 ES2017.Object，运行环境也要提供 Object.entries，或已有合适的兼容实现。添加类型库声明不会自动给旧运行环境补上这个方法。

这个写法适合“把当前对象的键值对转成展示文本”。如果后续逻辑依赖每个键与不同值类型之间的精确关系，不能假定任意对象经过 Object.entries 后都保留了这种对应类型。

类型断言必须有明确边界

对于由当前代码创建、没有额外运行时字段且不会在遍历中改变形状的对象，也可以局部断言键类型：

const keys = Object.keys(data) as Array<keyof typeof data>;
const lines = keys.map((key) => `${key}: ${data[key]}`);

as 不会校验对象，也不会过滤多余字段。来自 JSON、第三方库或结构更宽的对象，运行时可能有类型声明之外的键。不能仅凭函数参数写成某个接口，就把断言包装成对所有对象都安全的通用工具。

若数据本来就是任意字符串键的字典，可以使用 Record<string, string> 等索引类型，但这会放宽原来的固定字段约束。开启 noUncheckedIndexedAccess 后，读取未明确声明的键还会包含 undefined，调用方仍需处理缺失值。

修复后保持原有严格检查，确认不存在的固定键仍会报错，并用真实输入检查输出字段与顺序。不要通过关闭 noImplicitAny 或把对象整体断言为 any 来掩盖读取边界。若回退方案，恢复局部改动即可；本问题不需要修改运行时数据或关闭整个项目的类型检查。