ESLint 8.57.0忽略所有文件求助：Vite项目无法正常校验代码

1. 新旧配置文件冲突 #

ESLint从v8.23.0版本开始，默认优先读取扁平配置文件（eslint.config.js）。如果同时存在旧版的.eslintrc.js，两种配置逻辑会互相干扰，大概率会触发默认忽略规则，导致文件被跳过。

• 解决：只保留一种配置格式。如果用扁平配置，直接删除.eslintrc.js；如果习惯旧版配置，运行命令时加上--use-eslintrc参数，强制ESLint读取.eslintrc.js。

2. 扁平配置未指定文件匹配范围 #

扁平配置不会默认覆盖所有文件，必须手动定义要校验的文件路径。如果你的eslint.config.js里没有files字段，ESLint只会校验当前目录下的文件，不会递归处理src下的子文件和tsx后缀文件。

• 检查并修改配置，确保包含目标文件：

export default [
  {
    files: ["src/**/*.ts", "src/**/*.tsx"], // 明确覆盖src下所有ts/tsx文件
    rules: {
      // 你的规则配置
    }
  }
];

3. 命令行通配符被shell提前解析 #

运行npx eslint ./src/*.ts时，系统shell会先展开通配符，导致只匹配src目录下直接的.ts文件，子目录里的文件和tsx文件都会被漏掉。

• 解决：用引号包裹路径，让ESLint自己处理通配符：

npx eslint "./src/**/*.{ts,tsx}"

4. TypeScript相关插件未正确配置 #

如果没安装或配置TypeScript的ESLint插件，ESLint会默认忽略.ts/.tsx文件。

• 确保已安装依赖：@typescript-eslint/eslint-plugin和@typescript-eslint/parser
• 旧版.eslintrc.js配置示例：

module.exports = {
  parser: "@typescript-eslint/parser",
  plugins: ["@typescript-eslint"],
  extends: ["eslint:recommended", "plugin:@typescript-eslint/recommended"],
  overrides: [
    {
      files: ["*.ts", "*.tsx"],
      rules: {}
    }
  ]
};

• 扁平配置示例：

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

export default [
  js.configs.recommended,
  ...tseslint.configs.recommended,
  { files: ["src/**/*.{ts,tsx}"] }
];

5. 查看调试日志定位忽略原因 #

如果以上方法都没解决，用调试命令查看具体忽略逻辑：

npx eslint --debug src/App.tsx

在输出日志里找Ignored file because of ignore pattern相关内容，就能明确文件被忽略的具体原因。

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