gin模板不处理静态资源缓存，缓存由static()、staticfile()等机制决定；加v=参数导致404是因为static()不解析query string，必须将哈希嵌入文件名并确保html引用、url路径、磁盘路径三者完全一致。
Gin 模板本身不处理静态文件缓存，缓存行为完全由你如何提供静态文件（Static()、StaticFile()、中间件等）决定。模板里写的 <script src="/static/app.js"></script> 只是生成 HTML 字符串，真正影响缓存的是 HTTP 响应头和 URL 路径是否可被浏览器/CDN 识别为“不变资源”。
为什么模板里写 v= 参数后资源 404？
Gin 的 Static() 函数只按路径字符串匹配磁盘文件，不解析 query string。/static/app.js?v=1.2.3 和磁盘上 ./dist/static/app.js 是两个完全不同的路径，必然 404。
- 前端构建必须把哈希 baked 进文件名，例如输出
app.a8f5c1d.js，而不是靠 URL 参数加版本 - HTML 模板中引用的路径要同步更新：
<script src="/static/%7B%7B.jsName%7D%7D"></script>，其中.jsName来自构建时生成的 manifest JSON - 确保
r.Static("/static", "./dist/static")挂载的目录下真实存在该文件，且大小写、点、横线拼写完全一致 - Windows 下用
filepath.ToSlash()统一路径分隔符，避免\导致os.Stat失败
怎么让 / 根路径返回带缓存头的 index.html？
别用 c.File() + 手动加 header，它不支持 ETag；也别用 r.NoRoute() 兜底，那会绕过所有缓存逻辑。
- 直接用
r.StaticFile("/", "./dist/index.html")—— 注意第一个参数是"/"，不是"/index.html" - 它会自动设置
Content-Type: text/html; charset=utf-8和基于文件修改时间的ETag与Last-Modified - 配合
r.NoRoute()处理其他前端路由（如/about）时，仍用c.File()，但必须手动设c.Header("Cache-Control", "no-cache")，防止历史页面被缓存
如何给 Static() 加强缓存但避免更新失效？
gin.StaticOptions{MaxAge: 31536000} 能设强缓存，但它不提供 ETag 校验，且无法解决“HTML 已更新、JS 还是旧版”的错配问题。
- 只对带内容哈希的资源（如
main.3f8a2d.js）启用长缓存：r.Static("/static", "./dist/static", gin.StaticOptions{MaxAge: 31536000}) - 绝对不要对
/favicon.ico或未哈希的main.js设长缓存，否则调试时改了文件却看不到效果 - 开发时确认
gin.Mode是gin.ReleaseMode，DebugMode下Static()会强制设no-cache - 若需 304 支持（比如热更新 CSS），得自己封装
http.ServeContent()，用c.Writer.HTTPResponseWriter向下转型（仅 Gin v1.9+ 支持）
最易被忽略的一点：缓存是否生效，取决于 URL 是否变化。无论你加多少 header、设多长 max-age，只要文件名没变、HTML 引用没更新，用户就永远拿不到新资源。版本化文件名不是“可选项”，而是缓存策略成立的前提。
