0

0

如何通过高阶函数消除 Gulp 中重复的 Nunjucks 渲染任务

碧海醫心

碧海醫心

发布时间:2026-02-13 19:32:02

|

797人浏览过

|

来源于php中文网

原创

如何通过高阶函数消除 Gulp 中重复的 Nunjucks 渲染任务

本文介绍如何利用 javascript 高阶函数(闭包 + 函数工厂)将多个结构相同、仅路径不同的 gulp 构建任务抽象为单一可复用函数,避免代码重复,提升 gulpfile.js 的可维护性与扩展性。

本文介绍如何利用 javascript 高阶函数(闭包 + 函数工厂)将多个结构相同、仅路径不同的 gulp 构建任务抽象为单一可复用函数,避免代码重复,提升 gulpfile.js 的可维护性与扩展性。

在 Gulp 项目中,当需要对多个视图目录(如 src/views/home/ 和 src/views/blog/)分别执行相同的 Nunjucks 渲染流程时,若为每个目录单独编写一个任务函数(如 genNunJucks 和 genNunJucks2),会导致大量重复逻辑——不仅违反 DRY(Don’t Repeat Yourself)原则,还增加后续维护成本(例如修改模板引擎配置时需同步更新多处)。

理想的解决方案是:将“可变部分”(源路径、目标路径)参数化,把“固定部分”(渲染、美化、输出)封装为可复用逻辑。这正是高阶函数(Higher-Order Function)的典型应用场景:一个函数接收参数并返回另一个定制化的任务函数。

✅ 推荐做法:使用函数工厂(Function Factory)

我们定义一个工厂函数 createNunjucksTask,它接收 srcPath 和 destPath 作为参数,并返回一个符合 Gulp 4+ 任务签名(接受 cb 或返回 stream)的函数:

PopShort.AI
PopShort.AI

PopShort是一个AI短剧生成平台

下载
const { src, dest } = require('gulp');
const nunjucksRender = require('gulp-nunjucks');
const htmlbeautify = require('gulp-html-beautify');

// 工厂函数:生成专属 Nunjucks 渲染任务
function createNunjucksTask(srcPath, destPath) {
  return function genNunJucks(cb) {
    return src(srcPath)
      .pipe(nunjucksRender({
        path: ['src/views/'],
        ext: '.html',
        inheritExtension: false,
        envOptions: { watch: true },
        manageEnv: manageEnvironment,
        loaders: null
      }))
      .pipe(htmlbeautify({
        indentSize: 2,
        eol: '\n',
        indent_level: 0,
        preserve_newlines: false
      }))
      .pipe(dest(destPath))
      .on('end', cb) // 确保异步完成通知
      .on('error', cb); // 错误时传递给 Gulp
  };
}

// 使用示例:为不同视图路径创建独立任务
exports.genHome = createNunjucksTask(paths.views.src, paths.views.dest);
exports.genBlog = createNunjucksTask(paths.views.src2, paths.views.dest2);

? 关键点说明

  • createNunjucksTask 是纯函数,不依赖外部状态,易于测试与复用;
  • 返回的任务函数自动捕获传入的 srcPath/destPath(闭包机制),无需在调用时重复传递;
  • .on('end', cb) 和 .on('error', cb) 确保 Gulp 正确识别异步完成时机(Gulp 4+ 推荐方式,比直接调用 cb() 更健壮)。

? 进阶:批量注册任务(支持数组路径)

若需对 paths.views.srcList = ['src/views/home/', 'src/views/blog/', 'src/views/about/'] 批量生成任务,可进一步封装:

function registerNunjucksTasks(configs) {
  configs.forEach((cfg, index) => {
    const taskName = `genView${index + 1}`;
    exports[taskName] = createNunjucksTask(cfg.src, cfg.dest);
  });
}

// 批量注册
registerNunjucksTasks([
  { src: paths.views.src,  dest: paths.views.dest  },
  { src: paths.views.src2, dest: paths.views.dest2 },
  { src: 'src/views/about/', dest: 'dist/about/' }
]);

⚠️ 注意事项

  • 不要直接在工厂内调用 cb():原问题代码中 cb() 被无条件执行,但实际应由 stream 的 'end' 或 'error' 事件触发,否则 Gulp 可能提前结束任务;
  • 路径变量需已定义:确保 paths.views.src 等配置在调用前已正确初始化(建议统一管理于 config.js);
  • Gulp 版本兼容性:上述写法适用于 Gulp 4+;若使用 Gulp 3,请改用 return + cb 混合模式(不推荐,建议升级);
  • 性能考量:每个任务仍独立执行(非并发),如需并行构建,可用 gulp.parallel(...Object.values(exports)) 组合。

通过函数工厂模式,你不仅消除了重复代码,更将构建逻辑从“硬编码”升级为“可配置服务”,为未来接入更多模板引擎(如 Handlebars、EJS)或添加环境变量注入等能力预留了清晰的扩展接口。

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
scripterror怎么解决
scripterror怎么解决

scripterror的解决办法有检查语法、文件路径、检查网络连接、浏览器兼容性、使用try-catch语句、使用开发者工具进行调试、更新浏览器和JavaScript库或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

351

2023.10.18

500error怎么解决
500error怎么解决

500error的解决办法有检查服务器日志、检查代码、检查服务器配置、更新软件版本、重新启动服务、调试代码和寻求帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

326

2023.10.25

硬盘接口类型介绍
硬盘接口类型介绍

硬盘接口类型有IDE、SATA、SCSI、Fibre Channel、USB、eSATA、mSATA、PCIe等等。详细介绍:1、IDE接口是一种并行接口,主要用于连接硬盘和光驱等设备,它主要有两种类型:ATA和ATAPI,IDE接口已经逐渐被SATA接口;2、SATA接口是一种串行接口,相较于IDE接口,它具有更高的传输速度、更低的功耗和更小的体积;3、SCSI接口等等。

1417

2023.10.19

PHP接口编写教程
PHP接口编写教程

本专题整合了PHP接口编写教程,阅读专题下面的文章了解更多详细内容。

339

2025.10.17

php8.4实现接口限流的教程
php8.4实现接口限流的教程

PHP8.4本身不内置限流功能,需借助Redis(令牌桶)或Swoole(漏桶)实现;文件锁因I/O瓶颈、无跨机共享、秒级精度等缺陷不适用高并发场景。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2209

2025.12.29

java接口相关教程
java接口相关教程

本专题整合了java接口相关内容,阅读专题下面的文章了解更多详细内容。

36

2026.01.19

go语言闭包相关教程大全
go语言闭包相关教程大全

本专题整合了go语言闭包相关数据,阅读专题下面的文章了解更多相关内容。

140

2025.07.29

js正则表达式
js正则表达式

php中文网为大家提供各种js正则表达式语法大全以及各种js正则表达式使用的方法,还有更多js正则表达式的相关文章、相关下载、相关课程,供大家免费下载体验。

521

2023.06.20

pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法
pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法

本专题系统整理pixiv网页版官网入口及登录访问方式,涵盖官网登录页面直达路径、在线阅读入口及快速进入方法说明,帮助用户高效找到pixiv官方网站,实现便捷、安全的网页端浏览与账号登录体验。

20

2026.02.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号