如何配置ESLint遇首个错误即退出？含Linux及CI流水线场景

当然可行！虽然ESLint本身没有内置的「检测到第一个错误就立即退出」的CLI选项，但我们可以通过两种靠谱的方式实现这个需求——不管是本地逐个排查遗留代码的错误，还是CI流水线里节省计算时间都适用。

方案1：Shell管道快速实现（适合Linux环境） #

利用Shell的文本处理工具，实时监控ESLint的输出，一旦捕获到第一个错误就终止ESLint进程。

首先，先确认ESLint错误输出的特征（比如默认格式下错误行包含Error关键词），然后运行以下命令：

eslint --no-color your-source-dir/ | tee /dev/stderr | grep -m 1 "Error" && pkill -P $$ eslint

拆解一下每个部分的作用：

• --no-color：去掉彩色输出，避免干扰文本匹配
• tee /dev/stderr：把ESLint的输出同时打印到终端（否则管道会把输出传给grep，你看不到实时结果）
• grep -m 1 "Error"：匹配到第一个包含Error的行就停止执行
• && pkill -P $$ eslint：一旦grep捕获到错误，立即杀掉当前Shell进程下的所有ESLint子进程，强制停止检测

如果你的ESLint错误标识不是Error（比如用了其他格式化输出），可以先运行eslint your-source-dir/ --no-color查看错误行的特征，再调整grep的匹配关键词（比如换成✖或者特定前缀）。

方案2：自定义ESLint格式化器（更精准可靠） #

如果Shell方案的文本匹配不够精准，你可以写一个简单的自定义格式化器，直接通过ESLint的API判断错误，遇到第一个错误就抛出异常终止进程。

创建一个名为first-error-formatter.js的文件：

module.exports = function(results) {
  // 遍历每个文件的检测结果
  for (const result of results) {
    // 如果当前文件存在错误（severity=2为错误，1为警告）
    if (result.errorCount > 0) {
      const firstError = result.messages.find(msg => msg.severity === 2);
      // 打印第一个错误的详细信息
      console.error(`❌ Error in ${result.filePath}:`);
      console.error(`Line ${firstError.line}, Column ${firstError.column}: ${firstError.message}`);
      // 强制退出进程，终止ESLint
      process.exit(1);
    }
  }
  // 没有错误则正常退出
  process.exit(0);
};

然后运行ESLint时指定这个格式化器：

eslint --format ./first-error-formatter.js your-source-dir/

这个方案不会误判输出中的字符串，完全基于ESLint的检测数据，适合复杂场景或者自定义规则较多的项目。

CI流水线适配 #

在CI场景中，你可以结合方案1或方案2，再加上Shell的set -e命令确保流水线遇到错误立即终止：

set -e
eslint --no-color your-source-dir/ | tee /dev/stderr | grep -m 1 "Error" && exit 1

set -e会让Shell在任何命令执行失败时立即退出，exit 1会触发CI流水线标记为失败，完美适配大型代码库的快速失败需求。

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