TypeScript使用可选链索引对象时报No index signature错误如何解决

报错根本原因 #

你传入的str是宽泛的string类型，但strToNumber的键只有account/goals/metrics三个字面量类型，TS 不确认你传入的str一定属于这三个值的范围，所以禁止直接索引，和你写的可选链、默认值逻辑无关，这是 TS 的静态类型检查规则。

以下是不需要as和@ts-ignore的三种解决方案： #

方案1：收窄入参类型（最推荐，从根源避免非法输入） #

如果你的函数入参str本来就只允许传入strToNumber中存在的三个键，直接把入参类型修改为对应的字面量联合类型即可：

const func = (str: 'account' | 'goals' | 'metrics') => {
  const strToNumber = {
    account: 0,
    goals: 1,
    metrics: 2,
  };

  const number = strToNumber[str]; // 不再报错，也不需要可选链和默认值，因为一定能匹配到
};

如果不想手动写联合类型，也可以直接从对象推导类型：

// 把映射对象提到函数外，方便推导类型
const strToNumber = {
  account: 0,
  goals: 1,
  metrics: 2,
};
const func = (str: keyof typeof strToNumber) => {
  const number = strToNumber[str];
};

方案2：运行时类型校验（适合入参确实可能为任意字符串的场景） #

如果str可能是任意字符串，就封装通用类型守卫函数做合法性判断，既满足 TS 类型要求，运行时也更安全：

// 通用类型守卫，可抽出来全局复用
function isValidKey<T extends object>(key: string | number | symbol, obj: T): key is keyof T {
  return key in obj;
}

const func = (str: string) => {
  const strToNumber = {
    account: 0,
    goals: 1,
    metrics: 2,
  };

  const number = isValidKey(str, strToNumber) ? strToNumber[str] : 0;
};

方案3：给映射对象添加索引签名（写法最简单） #

如果不需要严格限制strToNumber的键，直接给它声明带字符串索引的类型即可：

const func = (str: string) => {
  const strToNumber: Record<string, number> = {
    account: 0,
    goals: 1,
    metrics: 2,
  };
  // 空值合并运算符??比||更稳妥，避免0、''等合法假值被覆盖
  const number = strToNumber[str] ?? 0;
};

额外提示 #

你原代码里的可选链?.是多余的，因为strToNumber是函数内部直接定义的对象字面量，不可能为undefined/null，不需要额外判断。

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