gulp 4.0.2升级Angular4.4.7/TS2.7.2后编译TS文件报错

• 核心诱因是Gulp 4.x的异步任务校验规则：Gulp 4要求所有任务必须通过返回流、Promise、调用回调等方式显式通知执行完成，你的代码中错误处理逻辑截断了流的正常返回链路，Gulp无法感知任务结束状态，就会抛出Did you forget to signal async completion?提示。
• 错误事件未正确托管：你在流末尾绑定的error事件仅打印错误日志，既没有将错误传递给Gulp的任务调度器，也没有主动结束流，导致错误成为未捕获异常，触发Unhandled 'error' event崩溃。
• TypeScript 2.7+版本适配问题：升级TS版本后，gulp-typescript插件会将编译输出拆分为JS、类型声明、sourcemap多个独立流，直接调用.pipe(typescript(tsProject))后继续链式调用的写法，可能无法正确等待所有文件处理完成，提前丢失结束信号。

直接替换原有compile任务代码即可：

/**
 * Compile TypeScript sources
 */
gulp.task("compile", gulp.series("clean", function () {
    const tsCompileResult = gulp.src("./App/**/*.ts")
        .pipe(inlineNg2Template({
            base: "/",
            target: "es6",
            indent: 2,
            useRelativePaths: false,
            removeLineBreaks: false,
            templateExtension: ".html",
            templateFunction: false
        }))
        .pipe(typescript(tsProject));

    // 返回JS产物处理流，保证Gulp能正确捕获任务完成信号
    return tsCompileResult.js
        .pipe(ignore("References.js"))
        .pipe(gulp.dest("dist/App"))
        .on('error', function (err) {
            console.error('TypeScript compile error:', err.message);
            // 出错后主动结束流，避免任务挂起或抛出未捕获异常
            this.emit('end');
        });
}));

修改点说明：

• 拆分TS编译输出流，单独处理JS产物流，解决TS 2.7+版本下gulp-typescript多输出流导致的结束信号丢失问题。
• 修正错误处理逻辑：打印错误信息后主动触发流的end事件，既不会让任务永久挂起，也不会抛出未捕获的错误事件。
• 保证整个任务最终返回的是完整可监听的文件流，Gulp可以正常捕获流的结束事件，判定任务执行完成。

如果你需要同时输出编译生成的.d.ts类型声明文件或sourcemap，需要引入merge2包合并多个输出流后再返回，示例：

const merge = require('merge2');
// 编译后合并流返回
return merge([
  tsCompileResult.js
    .pipe(ignore("References.js"))
    .pipe(gulp.dest("dist/App")),
  tsCompileResult.dts.pipe(gulp.dest("dist/App"))
]);

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