Gulp任务报错：调用默认函数时提示'done is not a function'求助

你遇到的核心问题是：修改后的copy函数依赖done回调来标记任务完成，但在默认任务中调用copy()时没有传递这个done参数，所以才会抛出done is not a function的错误。

问题根源拆解 #

Gulp 4+要求所有异步任务必须通过以下方式之一标记完成：

• 返回Gulp流（最常用）
• 返回Promise
• 调用传入的done回调
• 使用async/await

你修改后的copy函数是通过done回调来标记完成的，但在默认任务里直接调用copy()时，没有把默认任务自身的done参数传递给它，导致copy内部调用done()时找不到这个函数。

另外还有一个隐藏问题：即便你传了done，直接调用copyHtml()等函数后立刻执行done()，可能会导致这些异步的文件复制操作还没完成，Gulp就认为任务已经结束，引发潜在的文件同步问题。

正确的解决方式 #

推荐采用Gulp官方提倡的任务组合方式，避免手动处理done回调的传递问题：

方式1：用gulp.parallel/gulp.series组合任务

这是Gulp 4+的标准写法，能自动管理异步任务的完成状态：

const { parallel, series } = require('gulp');

// 假设你的子任务都返回Gulp流（正确的写法）
function copyHtml() {
  return gulp.src('src/**/*.html')
    .pipe(gulp.dest('dist'));
}

function copyCss() {
  return gulp.src('src/**/*.css')
    .pipe(gulp.dest('dist/css'));
}

function copyJs() {
  return gulp.src('src/**/*.js')
    .pipe(gulp.dest('dist/js'));
}

function copyImg() {
  return gulp.src('src/**/*.{png,jpg,gif}')
    .pipe(gulp.dest('dist/img'));
}

// 并行执行所有复制任务
const copy = parallel(copyHtml, copyCss, copyJs, copyImg);

// 顺序执行copy和browsersyncServe（如果需要先完成复制再启动服务）
function browsersyncServe(done) {
  // 你的browsersync初始化逻辑
  done();
}

exports.copy = copy;
exports.default = series(copy, browsersyncServe);

方式2：手动传递done回调（不推荐，仅作理解）

如果你坚持要手动调用函数，需要把默认任务的done参数传递给copy，同时确保异步操作的顺序：

function copy(done) {
  // 注意：如果copyHtml等是异步任务，这里需要确保它们全部完成后再调用done
  // 更稳妥的方式是让这些函数返回Promise，然后用Promise.all等待
  Promise.all([
    copyHtml(),
    copyCss(),
    copyJs(),
    copyImg()
  ]).then(() => done());
}

function defaultFunction(done) {
  // 传递done给copy
  copy(done);
  browsersyncServe();
}

exports.default = defaultFunction;

你忽略的关键细节 #

1. 回调参数的传递要求：依赖done回调的任务，被其他任务调用时必须传递该回调；
2. Gulp的异步任务管理逻辑：手动调用异步任务时，不能简单执行后立刻标记完成，必须等待所有异步操作结束；
3. 官方推荐的任务组合方式：Gulp 4+提供了parallel和series来简化多任务的异步管理，不需要手动处理回调传递。

内容的提问来源于stack exchange，提问作者Cédric