如何在Gulp中处理子进程错误并避免任务链崩溃

我完全懂你遇到的问题——就像你说的，有些子进程返回的错误根本不是致命的，比如工具已经跑完了所有检查只是有语法问题，但Gulp一碰到这种情况就直接把整个任务链搞崩，太闹心了。下面给你几个实用的处理方法，能帮你精准控制子进程错误的处理逻辑，避免整个任务链崩溃：

核心思路：接管错误判断，手动控制Gulp任务状态 #

Gulp默认会监听子进程的退出码，只要退出码非零就会标记任务失败，进而中断整个任务链。我们要做的就是自己接管错误的判断逻辑，区分「致命错误」和「非致命错误」，然后手动告诉Gulp任务该成功还是失败。

方法1：使用done回调处理异步任务（回调风格） #

这是Gulp异步任务最常用的方式，我们可以通过done回调来手动控制任务的完成状态：

const ChildProcess = require('child_process');
const gulp = require('gulp');

function childProcessTask(done) {
  ChildProcess.exec(
    `npx some-utility --noEmit`, // 替换成你实际使用的工具命令
    { encoding: "utf-8" },
    (error, stdout, stderr) => {
      // 先输出子进程的日志，方便排查问题
      console.log(stdout);
      if (stderr) console.error(stderr);

      // 关键：区分错误类型
      if (error) {
        // 这里根据实际情况定义「非致命错误」的判断条件
        // 比如：命令正常执行完成但返回非零码（如语法检查不通过）属于非致命
        // 而命令不存在、权限不足这类属于致命错误
        const isNonFatalError = error.code !== null && error.code !== 127; // 127通常是命令不存在

        if (isNonFatalError) {
          console.log('子进程返回非致命错误，任务将继续执行');
          // 不把错误传给done，Gulp会认为任务成功完成
          done();
        } else {
          // 真正的致命错误，通知Gulp任务失败
          done(error);
        }
      } else {
        // 没有错误，正常标记任务完成
        done();
      }
    }
  );
}

// 注册Gulp任务
gulp.task('my-task', childProcessTask);

方法2：使用Promise/async-await处理（更现代的风格） #

如果你更喜欢Promise风格的代码，可以用util.promisify把exec转换成Promise，再用async-await处理：

const ChildProcess = require('child_process');
const { promisify } = require('util');
const gulp = require('gulp');
const exec = promisify(ChildProcess.exec);

async function childProcessTask() {
  try {
    const { stdout, stderr } = await exec(`npx some-utility --noEmit`, { encoding: "utf-8" });
    console.log(stdout);
    if (stderr) console.error(stderr);
  } catch (error) {
    // 输出子进程的日志
    if (error.stdout) console.log(error.stdout);
    if (error.stderr) console.error(error.stderr);

    // 同样区分致命/非致命错误
    const isNonFatalError = error.code !== null && error.code !== 127;
    if (!isNonFatalError) {
      // 只有致命错误才抛出，让Gulp标记任务失败
      throw error;
    }
    // 非致命错误的话，什么都不抛，任务正常完成
    console.log('子进程返回非致命错误，任务将继续执行');
  }
}

gulp.task('my-task', childProcessTask);

关键细节说明 #

• 你可以根据工具的特性，灵活调整isNonFatalError的判断条件，比如有些工具会用特定的退出码表示不同的结果，你可以把这些非致命的退出码都加进去。
• 不管用哪种方式，核心都是不让Gulp默认处理子进程的退出码，而是由我们自己决定要不要触发任务失败。
• 如果你使用spawn而不是exec，逻辑是类似的：监听子进程的exit或close事件，判断退出码后手动调用done或者控制Promise的状态。

内容来源于stack exchange