本文介绍在 TypeScript 中为动态键值对对象（如复选框状态）定义类型的最佳实践，重点对比索引签名与 Record 工具类型的用法差异，并给出可直接落地的类型声明方案。
本文介绍在 typescript 中为动态键值对对象（如复选框状态）定义类型的最佳实践，重点对比索引签名与 `record` 工具类型的用法差异，并给出可直接落地的类型声明方案。
在开发表单组件（尤其是多选项复选框组）时，常需管理一个键值均为动态的对象，例如 checkboxesState：初始为空对象 {}，用户交互后逐渐扩展为 { "option1": true, "option2": false, "option3": true } 等形式。此时，类型安全至关重要——既要确保所有键为字符串、所有值为布尔值，又要保持代码简洁可维护。
TypeScript 提供两种主流方式定义此类对象类型，推荐优先使用 Record 工具类型：
interface FieldProps {
checkboxesState: Record<string, boolean>;
}✅ 优势说明：
- Record<string, boolean> 是标准库内置的泛型工具类型，语义清晰——“一个所有键为 string、所有值为 boolean 的对象”；
- 比传统索引签名 { [key: string]: boolean } 更具表现力，且在类型推导、IDE 补全和错误提示中行为更一致；
- 支持组合扩展，例如 Record<'option1' | 'option2' | 'option3', boolean> 可进一步约束键的字面量范围（适用于已知有限键名场景）。
⚠️ 注意事项：
- 若键名集合固定且已知（如仅允许 "theme" | "notifications" | "analytics"），应优先使用联合字面量类型：
checkboxesState: Record<'theme' | 'notifications' | 'analytics', boolean>;
- 避免过度宽泛：Record<string, boolean> 允许任意字符串键，若业务逻辑要求键必须来自某组预设值，建议配合 const 断言 + keyof typeof 或 satisfies 运算符做运行时校验；
- 不要混用 any 或 unknown 键类型（如 { [key: any]: boolean }），这会破坏类型安全性。
? 总结：对于动态复选框状态等典型映射型数据，Record<string, boolean> 是最简洁、标准且健壮的类型定义方式。它既满足运行时灵活性，又在编译期提供强约束，是 TypeScript 类型系统中“明确意图、减少冗余”的典范实践。
