本文介绍在 TypeScript 中为动态键名对象（如复选框状态）定义精确类型的两种主流方式：索引签名与 Record 工具类型，并对比其适用场景、类型安全性及实际编码建议。

本文介绍在 typescript 中为动态键名对象（如复选框状态）定义精确类型的两种主流方式：索引签名与 `record` 工具类型，并对比其适用场景、类型安全性及实际编码建议。

在开发表单组件（尤其是多选控件）时，常需管理一组动态命名的布尔状态，例如 checkboxesState——初始为空对象 {}，随用户交互逐步扩展为 { "option1": true, "option2": false, "themeDark": true } 等结构。此时，若仅用 any 或宽泛的 { [key: string]: boolean }，虽可运行，但会牺牲类型精度与开发体验。

推荐使用 TypeScript 内置的工具类型 Record<Keys, Type>，它专为此类“键值对统一约束”场景设计：

interface FieldProps {
  checkboxesState: Record<string, boolean>;
}

✅ 优势显著：

Galileo TypeScript sdk

完整的Galileo AI平台 TypeScript/JS SDK 参考，用于评估、观察和保护 GenAI 应用。适用于构建 Node.js 或 TypeScript 项目。

下载

• 语义清晰：Record<string, boolean> 明确表达“所有字符串键对应布尔值”的契约；
• 类型安全：编译器能严格校验赋值合法性（如 obj["x"] = 42 将报错）；
• 比索引签名更简洁：相比 { [key: string]: boolean }，Record 更具可读性与维护性，且在联合类型、映射类型组合中表现更稳定。

⚠️ 注意事项：

• Record<string, boolean> 允许任意字符串键（包括空字符串、数字字符串等），若需限定键名范围（如仅允许 "option1" | "option2" | "option3"），应改用字面量联合类型：

  type CheckboxKey = 'option1' | 'option2' | 'option3';
  interface FieldProps {
    checkboxesState: Record<CheckboxKey, boolean>;
  }

• 若对象可能包含额外非布尔属性（如元数据字段），则 Record 不适用，需回归索引签名并补充明确字段，或使用交集类型：

  interface FieldProps {
    checkboxesState: Record<string, boolean> & { _version?: number };
  }

? 总结：对于纯键值对、键名不确定但值类型确定的场景，优先选用 Record<string, T>；当键名可枚举时，用 Record<UnionLiteral, T> 进一步收窄类型；避免过度依赖 { [k: string]: T }，因其在类型推导和 IDE 支持上略逊于 Record。