使用grunt-cache-bust实现Cache Busting时，引用未更新问题排查

看起来你的基础配置已经搭好了，但没替换引用大概率是路径匹配或基础目录配置缺失导致的，我帮你梳理几个关键的调整点：

1. 补充baseDir配置项 #

grunt-cache-bust需要明确静态资源的根目录，才能正确关联index.html里的引用路径和实际资源文件。如果你的dist是构建后的根目录，一定要加上这个配置：

cacheBust: {
  taskName: {
    options: {
      assets: ['dist/scripts/**'],
      jsonOutput: true,
      createCopies: true,
      deleteOriginals: false,
      baseDir: 'dist' // 新增：指定资源的基础根目录
    },
    src: ['dist/index.html']
  }
}

2. 验证index.html里的资源引用格式 #

确保index.html中script标签的src路径是相对于dist目录的正确格式，避免绝对路径或错误的相对路径导致匹配失败：

<!-- 正确示例：相对于dist/index.html的路径 -->
<script src="scripts/app.js"></script>
<script src="scripts/controllers/controller1.js"></script>

<!-- 错误示例：这类路径可能无法被工具识别 -->
<script src="/scripts/app.js"></script>
<script src="../app/scripts/app.js"></script>

3. 检查资源路径匹配规则 #

确认assets配置的路径能覆盖到所有需要处理的脚本文件。如果dist/scripts的子目录结构复杂，也可以更明确地指定匹配规则：

assets: ['dist/scripts/*.js', 'dist/scripts/controllers/*.js']

4. 开启日志排查问题 #

如果调整后还是没生效，可以在options里添加verbose: true，任务执行时会输出详细的匹配日志，帮你定位哪个环节出了问题：

options: {
  // ...其他配置
  verbose: true
}

运行任务后，你可以通过两个方式验证效果：

• 查看dist/index.html里的script标签src是否已带上哈希值（比如scripts/app.abc123.js）
• 检查生成的cache-bust.json文件，里面应该包含原文件名和哈希文件名的映射关系

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