Angular 13升级至16后ESLint规则违规未被检测，寻求排查方案

问题场景 #

项目此前基于Angular 13，已完成TSLint到ESLint的迁移。升级至Angular 16后执行ng lint，始终返回All files passed linting，但代码中存在明确违反已启用规则的情况（例如启用eqeqeq规则后，仍有someVar == otherVar这类代码）。

已完成的调试动作：

• 以调试模式运行ng lint，确认规则已成功加载，且源码文件被遍历
• 执行命令node_modules/.bin/eslint --debug [path/to/specific/file-name.ts]，输出显示规则已加载且目标文件已被处理，但仍未检测到违规

排查方向及解决方案 #

1. 检查ESLint配置的规则生效状态 #

• 确认.eslintrc.json（或对应配置文件）中目标规则的设置，比如eqeqeq需设为"error"或"warn"，而非"off"：

  "rules": {
    "eqeqeq": ["error", "always"]
  }
  

• 排查配置中的overrides字段，是否针对TS文件设置了规则覆盖，导致目标规则被禁用：

  "overrides": [
    {
      "files": ["*.ts"],
      "rules": {
        "eqeqeq": "off" // 此类配置会直接导致规则失效
      }
    }
  ]
  

2. 对齐Angular ESLint插件版本 #

Angular 16要求@angular-eslint/*系列包版本匹配，执行以下命令更新至对应版本：

npm install @angular-eslint/schematics@16 @angular-eslint/eslint-plugin@16 @angular-eslint/eslint-plugin-template@16 @angular-eslint/template-parser@16 --save-dev

3. 排查ESLint忽略规则 #

• 查看.eslintignore文件，确认目标文件未被加入忽略列表
• 检查package.json中的eslintIgnore字段，是否存在对目标文件/目录的忽略配置

4. 验证TS配置与ESLint的集成 #

• 确认.eslintrc.json中parserOptions.project指向正确的tsconfig.json路径，保证ESLint能正确解析TS类型信息：

  "parserOptions": {
    "project": "./tsconfig.json",
    "tsconfigRootDir": "./"
  }
  

• 若项目使用多tsconfig文件，需在overrides中为不同文件组指定对应的project配置

5. 清除ESLint缓存 #

ESLint缓存可能导致规则未生效，执行以下命令清除缓存后重新检测：

ng lint --no-cache
# 或直接删除缓存文件
rm -rf .eslintcache

6. 绕开Angular CLI直接检测 #

跳过Angular CLI封装，直接用ESLint命令检测单个文件，查看真实检测结果：

npx eslint --no-cache --rule "eqeqeq: error" path/to/specific/file-name.ts

若此命令能检测到违规，说明问题出在Angular CLI的lint配置上，需检查angular.json中的lint配置项，确认lintFilePatterns包含目标文件，且未开启异常的缓存或过滤规则：

"lint": {
  "builder": "@angular-eslint/builder:lint",
  "options": {
    "lintFilePatterns": [
      "src/**/*.ts",
      "src/**/*.html"
    ],
    "cache": false // 可临时关闭缓存排查
  }
}

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