构建报错：@typescript-eslint/no-explicit-any 规则定义未找到

问题背景 #

• 通过npx degit reduxjs/redux-templates/packages/vite-template-redux my-app创建React Redux TypeScript项目
• 用npm i eslint + npx eslint --init添加ESLint配置
• 编写含any类型的代码时，ESLint能正常提示类型错误；但用// eslint-disable-next-line @typescript-eslint/no-explicit-any注释禁用规则后，执行npm run build失败，报错“Definition for rule '@typescript-eslint/no-explicit-any' was not found”，后续npm run start也出现相同错误

原因分析 #

这个报错的核心是ESLint找不到@typescript-eslint/no-explicit-any这条规则——该规则属于@typescript-eslint/eslint-plugin插件提供，要么是你没装这个插件，要么是ESLint配置文件里没正确加载它。

解决步骤 #

1. 补全依赖包 #

先确认是否安装了@typescript-eslint相关依赖，没装的话执行：

npm install --save-dev @typescript-eslint/eslint-plugin @typescript-eslint/parser

2. 修正ESLint配置 #

根据你使用的ESLint版本调整配置：

如果你用的是ESLint v9+（扁平配置，对应eslint.config.mjs）

确保配置文件中正确导入并启用typescript-eslint插件：

import globals from "globals";
import pluginJs from "@eslint/js";
import tseslint from "typescript-eslint";

export default [
  { files: ["**/*.{js,mjs,cjs,ts,jsx,tsx}"] },
  { languageOptions: { globals: globals.browser } },
  pluginJs.configs.recommended,
  // 加载TypeScript ESLint的推荐规则集
  ...tseslint.configs.recommended,
  {
    rules: {
      // 可自定义规则级别，比如warn/error/off
      "@typescript-eslint/no-explicit-any": "warn"
    }
  }
];

如果你用的是ESLint v8及以下（旧版配置，对应.eslintrc.js/.eslintrc.json）

确保配置包含解析器、插件和规则集：

{
  "parser": "@typescript-eslint/parser",
  "plugins": ["@typescript-eslint"],
  "extends": [
    "eslint:recommended",
    "plugin:@typescript-eslint/recommended"
  ],
  "rules": {
    "@typescript-eslint/no-explicit-any": "warn"
  }
}

3. 验证配置 #

执行npm run lint检查是否还存在规则找不到的报错，确认禁用规则的注释能正常生效。

4. 清理缓存（可选） #

如果问题依旧，尝试清理ESLint缓存：

npx eslint --clear-cache

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