Typescript接口索引签名报错：键可能未定义该如何解决？

问题原因 #

你定义的ClassSchedule接口使用了字符串索引签名，声明所有字符串键对应的值为string，但TypeScript会默认判定并非所有字符串键都必然存在于对象实例中，因此当你直接访问某个具体键时，会触发“键可能未定义”的类型报错。

解决方案 #

• 提前检查键是否存在
  在访问键之前先判断对象中是否包含该键，TypeScript会自动收窄类型，消除报错：

  const schedule: ClassSchedule = { math: '周一', english: '周二' };
  
  if ('math' in schedule) {
    console.log(schedule['math']); // 此处类型确定为string
  }
  

• 使用可选链操作符
  允许键不存在时返回undefined，通过?.操作符优雅处理潜在的未定义情况：

  const schedule: ClassSchedule = { math: '周一' };
  const historyClass = schedule['history']?.toUpperCase(); // 无报错，不存在时返回undefined
  

• 调整索引签名为非空类型（不推荐）
  如果你能确保所有字符串键都有对应值（实际场景中几乎不可能），可以用NonNullable强制类型，但会失去类型安全性：

  interface ClassSchedule {
    [key: string]: NonNullable<string>;
  }
  

  注意：这种方式风险极高，无法保证所有字符串键都存在对应值，不建议在实际开发中使用。

• 明确指定固定键（推荐）
  如果课程表只有固定的几个可选/必选键，直接声明这些属性比索引签名更安全：

  // 部分键可选
  interface ClassSchedule {
    math: string; // 必选
    english?: string; // 可选
    history?: string; // 可选
  }
  

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