TypeScript遍历OtpCode类型对象时类型不匹配问题求解

你定义了如下类型：

type OtpCode = {
  one: string;
  two: string;
  three: string;
  four: string;
  five: string;
  six: string;
};

尝试遍历对象并调用setValue时：

Object.keys(defaultValues).forEach((x, i) => {
  codeValuesForm.setValue(x, 'sometesttext');
});

TypeScript报错，提示string类型无法赋值给"one" | "two" | "three" | "four" | "five" | "six"类型，原因是**Object.keys默认返回string[]类型**——TypeScript无法保证运行时对象没有超出OtpCode定义的额外属性，所以不会将其自动推断为keyof OtpCode类型。

以下是几种可行的解决方法：

方法一：类型断言直接约束键类型 #

将Object.keys的结果断言为keyof OtpCode的数组，快速解决类型不匹配：

(Object.keys(defaultValues) as Array<keyof OtpCode>).forEach((x) => {
  codeValuesForm.setValue(x, 'sometesttext');
});

注意：仅当defaultValues严格符合OtpCode类型、没有额外属性时，这个断言是安全的。

方法二：手动定义键数组（更安全） #

如果对象键数量固定且较少，直接手动声明键数组，完全避免类型推断问题：

const otpKeys: Array<keyof OtpCode> = ['one', 'two', 'three', 'four', 'five', 'six'];
otpKeys.forEach((x) => {
  codeValuesForm.setValue(x, 'sometesttext');
});

这种方式不依赖Object.keys的推断，类型安全度最高。

方法三：封装类型安全的键获取函数 #

如果需要在多个场景复用类型安全的键遍历，可以封装一个工具函数：

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

// 使用时直接调用
getObjectKeys(defaultValues).forEach((x) => {
  codeValuesForm.setValue(x, 'sometesttext');
});

这个函数封装了类型断言，后续其他自定义类型的对象遍历都可以复用。

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