TypeScript字符串枚举嵌套后与字符串对比报错问题排查

定义字符串枚举UserRoles后，将其成员赋值给另一个枚举OrgRoles，但尝试对比OrgRoles成员与字符串时出现编译错误，错误提示：This comparison appears to be unintentional because the types 'OrgRoles' and 'string' have no overlap.ts(2367)。

代码示例：

enum UserRoles {
  admin = "Admin",
  user = "User"
}

// 正常编译并输出'true'
console.log(UserRoles.admin === "Admin");

enum OrgRoles {
  admin = UserRoles.admin,
  user = UserRoles.user
}

// 无法编译，触发TS2367错误
console.log(OrgRoles.admin === "Admin");

报错原因 #

TypeScript的枚举类型推断规则导致：

• UserRoles是显式字符串枚举，每个成员的类型被明确标记为字符串，因此可以直接和字符串对比。
• 当OrgRoles的成员值引用另一个枚举的成员时，TypeScript无法自动推断它是字符串枚举，会将其默认为数字枚举类型（即使实际运行时值是字符串）。数字枚举类型和字符串类型没有类型交集，所以直接对比会触发类型检查错误。

解决方法 #

方案1：显式声明OrgRoles为字符串枚举 #

通过类型断言强制TypeScript识别成员为字符串类型，将OrgRoles转为字符串枚举：

enum OrgRoles {
  admin = UserRoles.admin as string,
  user = UserRoles.user as string
}

// 现在可以正常编译
console.log(OrgRoles.admin === "Admin");

方案2：将枚举成员转为字符串后对比 #

使用String()或toString()方法把枚举成员转换为字符串类型，绕过类型检查：

// 方法1：使用String()转换
console.log(String(OrgRoles.admin) === "Admin");

// 方法2：调用toString()
console.log(OrgRoles.admin.toString() === "Admin");

方案3：使用const enum（适合无需运行时枚举对象的场景） #

将OrgRoles定义为const enum，TypeScript编译时会直接把枚举成员替换为对应的字符串值，相当于直接对比字符串：

const enum OrgRoles {
  admin = UserRoles.admin,
  user = UserRoles.user
}

// 编译通过，运行时等价于"Admin" === "Admin"
console.log(OrgRoles.admin === "Admin");

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