TypeScript中使用keyof typeof enum作为函数参数的类型问题

你在使用TypeScript数字枚举时遇到以下问题：

• 定义枚举enum Condition { NEW, USED }后，调用test(condition[condition.NEW])触发类型错误：Argument of type 'string' is not assignable to parameter of type "NEW" | "USED"
• 使用as keyof typeof condition强制转换虽能通过编译，但会绕过类型检查（如test('a' as keyof typeof condition)也能通过），存在安全风险

以下是两种安全的解决方式：

方案一：用类型守卫实现编译+运行时双重校验 #

先修正枚举定义（原代码存在语法错误），再编写类型守卫函数，既在编译时提供类型推断，又在运行时验证值的合法性：

// 正确的数字枚举定义
enum Condition {
  NEW,
  USED
}

// 枚举键的类型别名
type ConditionKey = keyof typeof Condition;

// 类型守卫：验证字符串是否为合法枚举键
function isConditionKey(str: string): str is ConditionKey {
  // 过滤数字枚举生成的数字键（如"0"、"1"），只保留字符串键
  const enumStringKeys = Object.keys(Condition).filter(key => isNaN(Number(key)));
  return enumStringKeys.includes(str);
}

function test(key: ConditionKey) {
  console.log(key);
}

// 合法场景：通过类型守卫校验后传递，编译+运行均正常
const enumValue = Condition[Condition.NEW];
if (isConditionKey(enumValue)) {
  test(enumValue);
}

// 非法场景：直接传递非法值触发编译错误
test('a'); // 错误：类型'"a"'不能赋值给类型'"NEW" | "USED"'
// 即使强制转换，运行时也会被守卫拦截
const invalidValue = 'a' as ConditionKey;
if (!isConditionKey(invalidValue)) {
  throw new Error('无效的Condition枚举键');
}

方案二：改用字符串枚举（推荐） #

如果业务场景允许，直接使用字符串枚举可从根源避免反向映射的类型问题——字符串枚举不会自动生成双向映射，枚举值本身就是与键一致的字符串类型：

enum Condition {
  NEW = 'NEW',
  USED = 'USED'
}

type ConditionKey = keyof typeof Condition;

function test(key: ConditionKey) {
  console.log(key);
}

// 直接传递即可，类型完全匹配
test(Condition[Condition.NEW]); // 编译正常

// 非法值直接触发编译错误
test('a'); // 错误：类型'"a"'不能赋值给类型'"NEW" | "USED"'

原理说明 #

数字枚举编译后会生成双向键值对（如Condition.NEW = 0、Condition[0] = "NEW"），但TypeScript对Condition[number]的类型推断仅为string，无法识别具体的枚举键集合；而字符串枚举的枚举值是显式字符串，类型直接对应枚举键的联合类型，无需额外处理。

内容的提问来源于stack exchange，提问作者César