ESLint 9+配置指定扫描文件夹不生效问题求助

问题原因 #

你的eslint.config.mjs仅定义了files路径，但未启用任何ESLint规则或共享配置，同时命令行执行eslint .会扫描所有文件——配置里的files只是用来限定规则的应用范围，而非指定要检查的文件集合。当没有规则可执行时，即使匹配了目标文件，也不会产生任何检查输出，导致你误以为配置未生效。此外，ESLint 9的扁平配置不会自动继承默认规则或React相关规则，必须手动引入。

正确配置方案 #

方案一：通过配置文件完全指定检查范围（推荐） #

修改eslint.config.mjs，引入必要的规则集，同时用ignores排除非目标文件，实现仅检查指定文件夹的效果：

import js from '@eslint/js';
import reactPlugin from 'eslint-plugin-react';
import globals from 'globals';

export default [
  // 启用JS基础推荐规则
  js.configs.recommended,
  // 针对目标文件夹启用React推荐规则
  {
    ...reactPlugin.configs.flat.recommended,
    files: ["src/components/workplace/**/*.js"],
    languageOptions: {
      globals: {
        ...globals.browser,
        ...globals.es2021,
        React: 'readonly'
      }
    }
  },
  // 排除所有非目标文件
  {
    ignores: ["**/*", "!src/components/workplace/**/*.js"]
  }
];

然后调整package.json的脚本，无需指定路径：

{
  "scripts": {
    "lint": "eslint"
  }
}

方案二：保留命令行扫描范围，仅对目标文件夹应用规则 #

如果不想修改命令行脚本，可在配置中限定规则仅作用于目标文件夹，确保配置包含启用的规则：

import js from '@eslint/js';
import reactPlugin from 'eslint-plugin-react';
import globals from 'globals';

export default [
  {
    files: ["src/components/workplace/**/*.js"],
    extends: [js.configs.recommended, reactPlugin.configs.flat.recommended],
    languageOptions: {
      globals: {
        ...globals.browser,
        React: 'readonly'
      }
    }
  }
];

此时执行eslint .会扫描所有文件，但只有src/components/workplace下的JS文件会被规则检查，其他文件不会产生检查结果。

关键要点 #

• files：指定当前配置块中规则的应用对象，而非直接指定要检查的文件
• ignores：通过取反语法!保留目标文件，排除其余所有内容，精准控制检查范围
• 必须引入规则集（如JS推荐规则、React插件规则），否则ESLint无规则可执行，检查无输出

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