描述 gruntplugin 模板生成器的使用与自定义 - 问题详情 - 创脉思

解读

面试官抛出此题，并非单纯考察“会不会用 grunt-init gruntplugin”，而是想验证候选人是否具备**“从 0 到 1 打造可复用 Grunt 插件”的工程化思维。国内一线团队普遍把 Grunt 当作“老项目基建”，新需求往往要二次封装私有插件以适配内网镜像、代码规范、CI 门禁等场景，因此必须同时掌握官方模板生成器的标准流程与深度定制能力。回答时要突出“模板层改造”而非“插件逻辑层”，让面试官确信你能在 30 分钟内交付一套团队级脚手架**。

知识点

grunt-init 与 gruntplugin 模板的关系：前者是通用项目脚手架引擎，后者是官方维护的专用模板集合。
模板目录规范：root/、template/、rename.json、filters.json 四大件，决定文件拷贝与变量替换规则。
变量注入机制：内置变量（{%= name %}、{%= description %}）与自定义变量（通过 prompt.js 交互式收集）。
过滤器（filters）：用 regex + function 对文件名、文件内容进行二次加工，例如把 src/ 批量重命名为 lib/。
私有模板发布：将改造后的模板推送到内网 GitLab 组包，并在 .grunt-init 目录建立软链，实现 grunt-init @mycompany/gruntplugin 一键安装。
合规改造点：
- 强制加入 eslint-config-xxx 依赖与 .eslintrc.js 模板，保证代码风格统一；
- 预置 changelog.md 与 commitlint.config.js，对接国内主流门禁系统；
- 在 Gruntfile.js 模板里内置 grunt-contrib-clean、grunt-contrib-copy 等必装任务，避免新人漏装。

答案

“gruntplugin 模板生成器”指 grunt-init 搭配官方 gruntplugin 模板，用于一键初始化符合 Grunt 官方规范的插件项目。标准使用分三步：

环境准备

npm i -g grunt-cli grunt-init
git clone https://github.com/gruntjs/grunt-init-gruntplugin.git ~/.grunt-init/gruntplugin

交互式生成
```
mkdir grunt-contrib-xxx && cd $_
grunt-init gruntplugin
```
根据提示填写插件名、描述、作者、仓库地址等，工具会自动替换模板变量并生成 tasks/、test/、README.md、package.json 等骨架。

本地验证

npm i
grunt test   # 官方模板已内置 mocha 用例，确保绿色通过

自定义模板时，不改动官方仓库，而是fork 到内网 GitLab，随后重点改造三处：

a) 扩展 prompt.js
新增交互项，如

{
  name: 'ci',
  message: '选择内网 CI 模板',
  default: 'gitlab',
  choices: ['gitlab', 'jenkins']
}

收集到的变量可在 template/.gitlab-ci.yml 中通过 {%= ci %} 动态渲染。

b) 编写 filters.js
当用户选择 ci=jenkins 时，自动删除 .gitlab-ci.yml 并生成 Jenkinsfile：

exports.after = function (value, props, done) {
  if (props.ci === 'jenkins') {
    require('fs').unlinkSync(props.destpath + '/.gitlab-ci.yml');
  }
  done();
};

c) 固化团队规范
在 template/ 里预置

.eslintrc.js：继承公司共享配置 @mycompany/eslint-config；
commitlint.config.js：强制 type(scope): subject 格式；
renovate.json：锁定淘宝镜像源，防止外网抖动。

最后把改造后的模板放到内网仓库 grunt-init-gruntplugin-mycompany，并通知团队

git clone <内网地址> ~/.grunt-init/myplugin

今后通过 grunt-init myplugin 即可在 10 秒内产出一个完全符合公司门禁与风格规范的私有 Grunt 插件。

拓展思考

如果团队已全面迁移到 Vite/Rollup，如何让老 Grunt 插件平滑暴露 ES Module 供新体系调用？
可在模板里预置 exports.esm = true 分支，自动生成 index.mjs 与 index.cjs 双入口，并借助 grunt-rollup 在 prepublishOnly 阶段二次打包，实现“老基建、新消费”。
国内很多项目要求离线构建，模板如何内置 node_modules.tar.gz 缓存策略？
在 filters.js 中检测 process.env.OFFLINE，若命中则把 package-lock.json 与缓存包一并拷入 vendor/ 目录，并在生成的 Gruntfile.js 里优先 grunt.loadTasks('./vendor/node_modules')，确保无网环境下 grunt 命令可用。