Gulp任务无法删除文件夹？相关报错问题咨询

我写的Gulp clean任务在指定文件路径（.wwwroot/css/site.min.css）时能正常运行，但把路径改成目录路径（.wwwroot/js/temp/）后，就出现错误提示：

The following tasks did not complete: clean
Did you forget to signal async completion?

当前环境版本：npm: 10.8.2，node: 20.17.0，这个问题是在我更新到rimraf 2.2.8并改用Node内置fs.promises库后出现的。

原代码如下：

var gulp = require("gulp");
const fs = require('fs').promises;

gulp.task('clean', async function (done) {
    try {
        await fs.rm(".wwwroot/js/temp/site.min.js", { recursive: true, force: true });
        done();
    } catch (error) {
        done(error);
    }
});

问题原因与解决方法 #

问题出在你同时混用了async函数和done回调——Gulp对异步任务的处理逻辑里，当你声明async函数时，它会自动等待函数返回的Promise完成；但你又手动调用done()，这在删除目录这类耗时稍长的操作中，会导致Gulp的异步状态判断混乱，触发错误。

简化修复版本

直接去掉done参数和相关调用，让async函数的Promise自动通知Gulp任务完成：

var gulp = require("gulp");
const fs = require('fs').promises;

gulp.task('clean', async function () {
    await fs.rm(".wwwroot/js/temp/", { recursive: true, force: true });
});

带错误捕获的版本

如果需要捕获错误并自定义处理，保留try/catch但直接抛出错误即可（Gulp会自动感知任务失败）：

var gulp = require("gulp");
const fs = require('fs').promises;

gulp.task('clean', async function () {
    try {
        await fs.rm(".wwwroot/js/temp/", { recursive: true, force: true });
    } catch (error) {
        console.error('删除目录失败:', error);
        throw error; // 让Gulp识别任务失败状态
    }
});

为什么删除文件时没出问题？因为删除单个文件的fs.rm操作极快，await完成后立即调用done()，两者时机几乎同步，Gulp没检测到冲突；但删除目录时操作耗时更长，done()和Promise的完成信号时机错位，导致状态判断异常。

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