如何让Grunt搜索web/assets/js/及子文件夹下的所有.js文件用于生成文档？

当然不用手动逐个指定所有子文件夹啦！Grunt支持Glob通配符模式，能轻松帮你匹配目标目录下所有层级的子文件夹里的.js文件，这是处理这类需求的标准做法。

核心解决方案：使用**通配符 #

在Grunt的文件路径配置里，**代表任意层级的子目录。你只需要把原来的路径从：

'web/assets/js/*.js'

改成：

'web/assets/js/**/*.js'

这样Grunt就会自动遍历web/assets/js/目录下的所有子文件夹，把里面的.js文件都包含进来。

举个实际配置例子 #

假设你用的是grunt-jsdoc插件生成文档，修改后的Gruntfile配置大概是这样：

grunt.initConfig({
  jsdoc: {
    build: {
      src: [
        'web/assets/js/**/*.js', // 匹配所有子文件夹的.js文件
        '!web/assets/js/vendor/**/*.js' // 可选：排除不需要生成文档的目录，比如第三方依赖
      ],
      options: {
        destination: './docs'
      }
    }
  }
});

额外的Glob模式小技巧 #

• *.js：仅匹配当前目录下的所有.js文件
• **/*.js：匹配当前目录及所有子目录下的.js文件
• !前缀：用来排除特定文件/目录，比如上面例子里排除vendor文件夹的操作

这样配置后，你就不用再操心新增子文件夹后还要手动修改Gruntfile了，完全自动化搞定~

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