Angular项目中eslint.config.mjs规则排除配置无效求助

安全阿岳

2026-6-16

Angular ESLint配置修改无效的排查方案

检查Angular CLI读取的配置文件路径
运行ng lint --verbose，查看输出中加载的配置文件路径，确认是否是你修改的eslint.config.mjs。如果存在旧版的.eslintrc.json等配置文件，Angular CLI可能优先读取旧文件。可以在angular.json的projects -> [你的项目名] -> architect -> lint -> options中添加"eslintConfig": "eslint.config.mjs"，强制指定配置文件。
确认ESLint版本支持Flat Config
查看package.json中的eslint版本，v8.23.0及以上才支持eslint.config.mjs格式的Flat Config。如果版本过低，要么升级ESLint和@angular-eslint相关依赖包，要么改用旧版.eslintrc.json配置，在rules字段中添加"prefer-const": "off"来关闭规则。
清除ESLint缓存
ESLint会缓存检查结果，修改配置后可能未生效。运行ng lint --no-cache，强制跳过缓存重新执行检查。
检查lint任务的文件范围与嵌套配置
查看angular.json中lint任务的files配置，确认是否指定了特定文件范围，导致修改的配置未覆盖目标文件。同时检查项目子目录中是否存在其他ESLint配置文件（如.eslintrc），这些文件可能会覆盖根目录的配置。
Flat Config中关闭规则的正确写法
若使用eslint.config.mjs，不能直接清空配置数组（Angular CLI会 fallback 到内置默认配置），正确关闭规则的写法如下：
```
export default [
  {
    rules: {
      'prefer-const': 'off'
    }
  }
];
```