如何将对象字符串属性映射为布尔值？解决TypeScript类型不兼容问题

问题根源分析 #

你的代码存在两个核心问题导致类型错误：

1. NextType 映射类型定义错误
   原定义中使用 T[keyof T]（对象所有值类型的联合）判断，会导致只要对象包含非字符串属性，所有属性都会被映射为 string。正确逻辑应该针对每个键 K 单独判断其值类型 T[K]。

2. 函数返回不完整对象
   你的函数仅返回包含指定键的对象，但 NextType<T> 要求包含原对象的所有键。TypeScript 无法推断返回的部分对象符合完整的 NextType<T> 结构。

修复步骤 #

1. 修正 NextType 定义

调整映射类型，针对每个键的具体值类型做判断：

type NextType<T extends object> = {
  [K in keyof T]: T[K] extends string ? boolean : string;
};

2. 调整函数返回完整对象

修改函数，复制原对象所有属性后再更新目标键，确保返回对象包含所有必要键：

function mapObjectStringPropToBoolean<T extends object>(
  key: keyof T,
  payload: T
): NextType<T> {
  // 复制原对象并将指定键转换为布尔值
  return {
    ...payload,
    [key]: Boolean(payload[key])
  } as NextType<T>; // 类型断言告知 TypeScript 正确类型
}

3. （可选）添加更严格的键约束

若希望函数仅接受值类型为字符串的键，可添加泛型约束，避免传入非字符串属性的键：

function mapObjectStringPropToBoolean<T extends object, K extends keyof T>(
  key: K extends (T[K] extends string ? K : never),
  payload: T
): NextType<T> {
  return {
    ...payload,
    [key]: Boolean(payload[key])
  } as NextType<T>;
}

为什么原代码中 as NextType<T> 有效？ #

TypeScript 类型系统无法自动推断修改后的对象完全符合 NextType<T> 结构——尤其是仅更新部分属性时。类型断言相当于告诉 TypeScript："我确认这个值的类型是 NextType<T>"，从而绕过类型检查。只要你的业务逻辑正确，这种断言是安全的。

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