ESLint v9在TypeScript项目中误将JS文件作为配置引发报错

这不是ESLint的Bug，百分百是你的配置问题，核心原因是ESLint v9的扁平配置逻辑和你当前的配置写法不匹配，导致非目标文件被纳入检查范围，进而触发错误。

常见问题点及解决方法 #

1. 未显式忽略不需要检查的JS文件
   ESLint v9默认不会自动忽略配置文件（如eslint.config.mjs、webpack.config.js）或构建产物目录（如dist/），即使你指定了只检查**/*.ts文件，只要这些JS文件没被明确排除，ESLint仍可能尝试处理它们——尤其是当这些文件里包含ESLint注释指令时，就会触发「规则未找到」「禁用指令未使用」这类错误。

解决：在配置最顶部添加全局忽略规则：

export default [
  // 先排除所有不需要检查的文件
  {
    ignores: [
      "eslint.config.mjs",
      "webpack.config.js",
      "dist/**/*", // 替换成你的产物目录
      "node_modules/**/*" // 可加可不加，ESLint默认忽略node_modules
    ]
  },
  // 再定义TS文件的检查规则
  {
    files: ["**/*.ts"],
    languageOptions: {
      parser: "@typescript-eslint/parser",
      parserOptions: {
        ecmaVersion: "latest",
        sourceType: "module",
        project: "./tsconfig.json"
      }
    },
    plugins: {
      "@typescript-eslint": require("@typescript-eslint/eslint-plugin")
    },
    rules: {
      // 你的TS规则配置
    }
  }
];

2. 配置对象未限定作用范围
   如果你的配置里存在没有指定files字段的配置对象，ESLint会将这些规则全局应用到所有文件，包括JS文件。而JS文件中如果有针对TypeScript规则的注释（比如// eslint-disable-next-line @typescript-eslint/no-unused-vars），但JS文件的上下文里并没有加载@typescript-eslint插件，就会直接报错「规则未找到」。

解决：确保所有规则配置都包裹在指定files: ["**/*.ts"]的配置对象中，不要出现全局规则配置。

3. 命令行参数干扰
   如果你运行ESLint时在命令行指定了额外文件（比如npx eslint .），虽然配置里的files会过滤目标文件，但如果忽略规则没写好，仍可能出现意外。建议直接运行npx eslint（不带参数），让配置里的files和ignores完全控制检查范围。

验证方法 #

修改配置后，运行npx eslint --debug，观察输出中「Processing file」的列表，确认只有.ts文件被处理，JS文件都被标记为「Ignored」即可。

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