Gulp4调用/导入任务时出现“AssertionError: Task never defined”报错

我来帮你拆解这个问题——你遇到的坑其实是任务加载顺序搞出来的锅。

为什么会报错？ #

你用require-dir加载tasks目录下的文件时，它默认是按文件名的字母顺序来加载的。比如build.js的首字母比clean.js靠前，那build.js会先被加载。这时候build.js里写的gulp.series('clean')就会去找一个还没被定义的任务，直接触发断言错误，把整个Gulp的任务注册表搞崩了。所以后面哪怕你跑gulp dev，因为整个任务系统已经初始化失败了，自然找不到clean任务。

怎么解决？给你三个方案 #

方案1：临时救急——改文件名控顺序 #

最简单的临时办法是给clean.js改个名字，比如叫0-clean.js，让它在build.js之前被加载。这样build.js加载时clean任务已经存在了，就不会报错。不过这招有点土，文件名看着乱，适合临时测试用，不推荐长期用。

方案2：推荐最佳实践——用函数代替任务名 #

Gulp 4本来就推荐直接用任务函数来定义依赖，完全不用管加载顺序。具体这么改：

1. 先改clean.js，把任务函数导出来：

import gulp from 'gulp';
import del from 'del'; // 换成你实际用的清理工具

// 定义清理函数并导出
export const clean = () => {
  return del(['dist/**/*']);
};

// 可选：注册成单独任务，方便直接跑`gulp clean`
gulp.task('clean', clean);

2. 然后改dev.js，直接导入clean函数用：

import gulp from 'gulp';
import { clean } from './clean';

// 直接传函数，不用写字符串'clean'
gulp.task('dev', gulp.series(clean));

3. build.js也一样改：

import gulp from 'gulp';
import { clean } from './clean';

gulp.task('build', gulp.series(clean));

这么做的好处太多了：不用纠结文件加载顺序，代码一眼就能看到依赖的是哪个函数，还能避免拼写任务名出错的问题。

方案3：进阶架构——统一在gulpfile注册任务 #

如果你的任务多，建议把任务定义和注册分开，所有任务函数都导出，然后在gulpfile.babel.js里统一注册，这样依赖关系一目了然：

1. 每个任务文件只导出函数，比如clean.js：

import del from 'del';
export const clean = () => del(['dist/**/*']);

dev.js：

// 这里写dev的具体逻辑，比如编译、启服务
export const dev = () => {
  // 你的dev任务代码
};

2. 在gulpfile.babel.js里集中注册：

import gulp from 'gulp';
import requireDir from 'require-dir';

// 导入所有任务函数
const tasks = requireDir('./tasks', { recurse: true });

// 注册clean任务
gulp.task('clean', tasks.clean.clean);

// 注册dev，依赖clean
gulp.task('dev', gulp.series(tasks.clean.clean, tasks.dev.dev));

// 注册build，依赖clean
gulp.task('build', gulp.series(tasks.clean.clean, tasks.build.build));

这种方式适合复杂项目，所有任务的依赖关系都在gulpfile里，管理起来特别方便。

额外要排查的点 #

• 确认require-dir安装正常：跑npm list require-dir看看版本，有没有兼容问题
• 检查有没有循环依赖：比如A任务依赖B，B又依赖A，这种会导致加载失败
• 你的Gulp版本没问题：CLI 2.0.1和Local 4.0.0是兼容的，不用换版本

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