TypeScript中何时使用Record<string,T>与{ [index: string]: T }？

好问题！这两种TypeScript类型看起来几乎等效，但在语义表达、灵活性和适用场景上还是有明确区别的，我来帮你梳理清楚：

优先选择Record<string, T>的场景 #

• 语义化的字典/映射场景：当你需要明确表达“这是一个以字符串为键、T类型为值的键值对集合”时，Record<string, T>的语义更直观。它是TypeScript官方提供的工具类型，专门用于这种通用的记录型结构，其他人看代码时能立刻get到你的意图。
  比如处理配置、状态映射时：

  // 用户偏好配置，用Record更清晰
  type UserPreferences = Record<string, boolean>;
  const prefs: UserPreferences = { darkMode: true, autoSave: false };
  

• 简洁性与工具类型组合：当你需要和其他工具类型（比如Partial、Pick）搭配使用时，Record的写法更简洁清爽。比如：

  // 部分可选的用户字段映射
  type PartialUserFields = Record<string, Partial<User>>;
  

  比冗长的{ [key: string]: Partial<User> }写法更适合在泛型函数或复杂类型定义中使用。

必须使用{ [index: string]: T }的场景 #

• 需要混合固定属性与索引签名：如果你想同时拥有“任意字符串键的索引签名”和“特定类型的固定属性”，只能用这种语法。因为Record<string, T>要求所有属性的类型都必须是T，无法兼容不同类型的固定属性。
  比如：

  // 正确：既有固定的id属性，又有其他数值类型的动态属性
  type EntityWithMeta = {
    id: string; // 固定属性，类型为string
    [key: string]: number; // 其他任意字符串键都是number类型
  };
  const product: EntityWithMeta = { id: "prod_123", price: 99, stock: 50 };
  
  // 错误：Record<string, number>无法兼容string类型的id属性
  // type BadEntity = Record<string, number> & { id: string };
  

• 自定义索引键的语义化命名：如果你想给索引键起个更有业务意义的名字（比如[userId: string]），用这种语法可以提升代码可读性：

  type UserScoreMap = {
    [userId: string]: number; // 明确键是用户ID，语义更具体
  };
  

团队风格与约定 #

如果团队没有特殊约定，日常的通用字典映射优先用Record<string, T>，它更符合TypeScript的工具类型设计理念；当需要扩展固定属性或自定义索引键语义时，再切换到{ [index: string]: T }写法。

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