TypeScript中Object.keys遍历指定键类型对象报错的疑问

核心原因 #

你定义的wfsConfig键类型确实是NationStateType（即'berlin' | 'hamburg'），但**Object.keys()的返回类型固定为string[]**，这是TypeScript的设计规则：

• JavaScript中对象的键本质都是字符串（或Symbol），TypeScript无法确保Object.keys()返回的键完全匹配你定义的字面量类型（比如存在对象被额外添加键的可能性），所以会保守地将返回值类型设为string[]。
• 当你用string类型的states去索引wfsConfig时，TypeScript认为这个字符串可能不是合法的NationStateType键，因此抛出类型错误。

解决方案 #

有两种常用的修复方式：

1. 类型断言（简单直接） #

将states断言为NationStateType，明确告诉TypeScript这个键属于我们定义的合法类型：

Object.keys(wfsConfig).forEach((states) => {
  console.log(wfsConfig.berlin.parcels)
  wfsConfig[states as NationStateType] // 不再报错
})

2. 类型守卫（更严谨） #

如果想避免直接断言，可通过类型守卫缩小states的类型范围：

function isNationState(state: string): state is NationStateType {
  return (nationStates as readonly string[]).includes(state)
}

Object.keys(wfsConfig).forEach((states) => {
  console.log(wfsConfig.berlin.parcels)
  if (isNationState(states)) {
    wfsConfig[states] // 类型守卫后，states被识别为NationStateType
  }
})

补充说明 #

如果你想让Object.keys()直接返回NationStateType[]，可以自定义一个工具函数来封装类型转换，比如：

function getObjectKeys<T extends object>(obj: T): Array<keyof T> {
  return Object.keys(obj) as Array<keyof T>
}

getObjectKeys(wfsConfig).forEach((states) => {
  wfsConfig[states] // states类型为NationStateType，无报错
})

这个工具函数利用keyof T获取对象的键类型，再通过断言转换返回值类型，适合频繁使用的场景。

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