Gulp任务异常行为解析：无定义任务却正常运行的困惑

1. html-template:join任务的核心逻辑 #

这个任务是多阶段文件处理流：

• 先通过Gulp插件（比如gulp-merge-json或自定义脚本）读取./src/template-data下的所有JSON文件，合并为单个data.json；
• 将合并后的JSON输出到./build/templated-data-combined/目录；
• 同时把合并后的JSON作为模板数据，传入模板编译插件（比如gulp-nunjucks-render、gulp-handlebars），完成HTML模板的编译输出。

2. html:build-templates读取build/data/data.json的原因 #

不存在“无脚本迁移”的情况，只是迁移逻辑被隐式处理了，常见场景：

• 任务流分支输出：html-template:join任务在合并JSON后，通过Gulp的流分支（比如duplexer2或多dest()调用）同时将data.json输出到./build/templated-data-combined/和./build/data/两个目录，你没注意到这个分支逻辑；
• 隐式任务依赖：html:build-templates的任务定义中，实际依赖了某个你没留意的前置任务（比如copy:template-data），这个前置任务负责将templated-data-combined/data.json复制到build/data/；
• 文件监听自动同步：如果开启了Gulp的文件监听（gulp-watch），当templated-data-combined/data.json生成后，监听规则自动将其同步到build/data/目录。

3. html:build调用不存在的JSON:merge-json却能生成文件的原因 #

这是Gulp任务机制的“隐性细节”导致的，常见可能性：

• 任务名拼写/大小写误差：Gulp任务名严格区分大小写，但你的Gulpfile中可能实际存在小写的json:merge-json任务，html:build里的大写是笔误，Gulp执行了正确的任务；
• 动态任务注册：如果使用了gulp-load-plugins这类工具，它会自动加载gulp-merge-json插件并生成对应的任务，你没在Gulpfile中显式看到任务定义，但实际已被动态注册；
• 任务别名：html-template:join任务被设置了JSON:merge-json的别名（比如gulp.task('JSON:merge-json', gulp.series('html-template:join'))），调用别名等同于执行原任务；
• 缓存/旧文件残留：首次运行时已有其他任务生成了build/data/data.json，后续即使任务调用报错，Gulp仍能读取已存在的文件完成模板编译（这种情况Gulp控制台会输出任务不存在的报错，你可能没注意）；
• Gulp版本差异：Gulp 3.x的任务依赖机制是自动执行所有前置依赖，若html:build的依赖列表写错，但其他前置任务已经生成了目标文件，就会出现“任务不存在但文件已生成”的假象。

排查建议 #

• 查看Gulpfile的完整代码，重点检查html-template:join的流处理逻辑，是否有多个dest()输出；
• 运行gulp --tasks命令，查看所有已注册的任务列表，确认是否存在JSON:merge-json或其别名；
• 执行任务时添加--verbose参数，查看Gulp实际执行的任务序列和文件处理细节；
• 清理build/目录后重新运行html:build，观察是否还能生成data.json，以此判断是缓存还是任务隐式执行导致的。

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