Github Action中ESLint存在错误却显示检测通过的问题

DevOps 小满

2026-8-24

Github Action中ESLint明明有错误却检测通过的排查方案

修复ESLint命令的换行格式
你的YAML工作流里，Run ESLint步骤的命令换行没有加连接符，导致实际执行的只有npx eslint .，后面的--config和--ext参数根本没被ESLint接收。这会导致ESLint可能使用默认配置，或者没检测到你指定扩展名的文件，自然抓不到错误。
修正后的步骤代码如下：
```
- name: Run ESLint
  run: npx eslint . \
    --config .eslintrc.json \
    --ext .js,.jsx,.ts,.tsx
  continue-on-error: false
```
注意每行末尾的\，它是YAML中连接多行命令的必要符号，确保所有参数都能传递给ESLint。
检查.eslintrc.json的有效性与规则配置
确认仓库根目录下存在.eslintrc.json文件，并且文件中开启了对应错误的检测规则。比如代码里有未定义变量的错误，要确保no-undef规则被设为"error"；如果是TypeScript语法问题，要确认已正确配置并启用@typescript-eslint相关规则。
确保项目依赖完整安装
当前步骤只安装了ESLint和SARIF格式化工具，如果你配置的ESLint规则依赖其他插件（比如@typescript-eslint/eslint-plugin、eslint-plugin-react等），这些插件未安装的话，对应的规则不会生效，错误也检测不出来。建议替换单独安装ESLint的步骤，直接安装项目所有依赖：
```
- name: Install dependencies
  run: npm install
```
这样能保证所有ESLint相关的插件和依赖都被正确安装。
本地验证ESLint执行结果
在本地电脑上运行和Action里相同的命令：npx eslint . --config .eslintrc.json --ext .js,.jsx,.ts,.tsx，看是否能检测出预期的错误。如果本地也检测不到，说明问题出在ESLint配置本身；如果本地能检测到，再排查Github Action环境和本地的差异。