升级@typescript-eslint/parser至8.x后枚举索引签名触发未使用变量错误

1. 优雅解决方案 #

直接修改ESLint规则配置，开启ignoreTypeVariables选项，让规则自动忽略类型上下文定义的变量（比如映射类型里的scope这类遍历符）。在你的ESLint配置文件中更新规则：

{
  "rules": {
    "@typescript-eslint/no-unused-vars": [
      "error",
      {
        "ignoreTypeVariables": true
      }
    ]
  }
}

这个选项专门针对类型层面的变量（包括映射类型遍历符、泛型参数等），无需改动业务代码，是最简洁的解决方式，v8.x版本均支持该配置。

2. 忽略此类情况的方法 #

除了全局配置，还有两种灵活的忽略方式：

• 单段代码忽略：在触发错误的映射类型上方添加注释，仅跳过当前行的规则检查：

  // eslint-disable-next-line @typescript-eslint/no-unused-vars
  export type AuthorizationPayload = {
    [scope in Scope]?: Permission[]
  }
  

• 批量变量匹配忽略：如果有多个类似的遍历变量名（如key、prop、scope），可以通过varsIgnorePattern配置正则匹配这些变量名，一次性解决同类问题：

  {
    "rules": {
      "@typescript-eslint/no-unused-vars": [
        "error",
        {
          "varsIgnorePattern": "^(scope|key|prop)$"
        }
      ]
    }
  }
  

3. 官方误报的原因 #

这是v8版本规则重构导致的回归问题。@typescript-eslint团队在v8版本中重写了no-unused-vars的底层检测逻辑，目标是提升运行时未使用变量的检测精度，覆盖更多之前遗漏的场景。但重构过程中，规则错误地将仅存在于类型检查阶段的遍历变量（比如映射类型中的scope，不会被编译到最终代码）判定为运行时未使用变量，从而触发了错误提示。官方已在后续小版本（如v8.6及以上）修复了该问题，升级到对应版本也能自动解决。

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