如何在React/Next项目package.json脚本中用一行ESLint命令显示所有文件错误

1. 调整package.json中的脚本命令 #

直接在package.json的scripts字段里修改或添加对应命令，确保ESLint遍历项目所有文件并输出完整错误信息：

{
  "scripts": {
    "lint": "eslint . --ext .js,.jsx,.ts,.tsx --no-error-on-unmatched-pattern --max-warnings 0",
    "errors": "eslint . --ext .js,.jsx,.ts,.tsx --no-error-on-unmatched-pattern --quiet"
  }
}

参数说明：

• .：指定检查当前目录下所有文件
• --ext .js,.jsx,.ts,.tsx：明确指定要检查的文件扩展名，适配React/Next的JS/TS类文件
• --no-error-on-unmatched-pattern：避免因没有匹配到某类扩展名文件而抛出额外错误
• --max-warnings 0：将所有警告也当作错误输出，若仅需显示错误可改用--quiet
• --quiet：仅输出错误，过滤掉警告，适合npm run errors命令的需求

2. 检查并调整忽略配置 #

默认ESLint会读取.eslintignore和.gitignore的规则跳过文件，若需要检查被忽略的文件，可添加--no-ignore参数：

修改errors命令示例：

"errors": "eslint . --ext .js,.jsx,.ts,.tsx --no-error-on-unmatched-pattern --quiet --no-ignore"

注意：--no-ignore会让ESLint检查所有文件（包括node_modules这类通常无需检查的目录），建议优先通过.eslintignore手动管理需要跳过的目录，而非依赖默认忽略规则。

3. 验证命令执行 #

执行npm run lint或npm run errors，此时ESLint会遍历项目中所有指定扩展名的文件，输出全部错误信息（若添加了--max-warnings 0则同时包含警告）。

额外提示 #

如果是用Next.js官方脚手架创建的项目，默认已集成ESLint，但默认脚本可能仅检查已修改文件，替换成上述命令即可覆盖默认行为。

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