Gin 不支持模板自动刷新，修改 HTML 文件后页面不变是因为模板仅在启动时加载一次；开发时需用 air 等工具监听文件变化并重启服务，生产环境禁用热重载。
Gin 框架本身不支持“自动刷新模板内容”——模板文件一旦加载进内存，就不会随磁盘变更而重新读取。开发阶段想看到 HTML 修改立即生效，必须手动触发重载或启用调试机制。
为什么改了 index.html 但页面没变？
这是 Gin 模板最常被误解的一点：Gin 默认只在启动时加载一次模板（通过 LoadHTMLGlob 或 LoadHTMLFiles），后续对文件的修改完全不会影响已加载的 *template.Template 实例。浏览器刷新只是重新执行已缓存的模板逻辑，不是重新读文件。
- 你改的是磁盘上的
templates/index.html，但 Gin 运行时用的是内存里那个旧版本 -
c.HTML(200, "index.html", data)中的"index.html"是模板名（key），不是路径；它从已加载的模板集合中查找匹配名称的定义 - 若使用
SetHTMLTemplate手动传入template.Must(template.ParseFiles(...))，同样只解析一次，无热更新
开发阶段如何实现模板实时刷新？
没有官方热重载，但有可靠、轻量的替代方案：每次保存模板文件后，主动重启服务，或用第三方工具监听文件变化并 reload。不建议在生产环境开启任何“自动重载”逻辑。
- 最简单：用
air（推荐）或fresh启动项目，配置监听templates/**/*和*.go，保存即重建二进制并重启 - 手动 reload：改完模板后，Ctrl+C 停掉进程，再
go run main.go—— 虽土但零依赖、100% 可控 - 避免用
fsnotify自己写热重载：Gin 的模板对象不是线程安全可替换的，强行 swap 容易 panic 或渲染错乱
LoadHTMLGlob 的路径模式和命名陷阱
模板能否被正确加载，直接决定你“改了却看不到”的根本原因。路径写错、命名不一致、glob 匹配失败，都会导致 c.HTML 渲染空白页或报 template: "xxx" is undefined 错误。
-
r.LoadHTMLGlob("templates/**/*")才能匹配子目录（如templates/users/card.html），"templates/*"只扫一级 - 模板名是文件 basename，不含扩展名也不含路径：
c.HTML(200, "card", data)对应templates/users/card.html，不是"users/card.html" - 若多个文件有相同 basename（如
templates/a/card.html和templates/b/card.html），后者会覆盖前者，Gin 不报错但行为不确定 - Windows 下路径分隔符用
/（Go 标准库统一处理），不要写\，否则 glob 失效
局部刷新（Fragment）和真·动态更新的区别
注意别混淆概念：“刷新模板内容”常被误以为是前端意义上的局部 DOM 更新。Gin 是服务端渲染框架，所谓“局部刷新”，其实是后端返回一段 HTML 片段（如用户卡片），由前端 JS 插入到页面某区域 —— 这需要你额外写 AJAX 请求 + fragments.ExecuteTemplate，和模板热重载无关。
- 服务端局部渲染用
fragments.ExecuteTemplate(c.Writer, "user_card.html", user)，注意第二个参数是文件名，不是{{define}}名 - 若该 fragment 模板用了自定义函数（如
formatTime），必须在创建fragments时用Funcs()显式注入，主模板的函数不会自动继承 - 这种“局部刷新”仍需完整 HTTP 请求，不是 WebSocket 或 SSE；要真正实时响应数据变化，得配合前端轮询或后端推送
真正容易被忽略的点在于：模板重载不是 Gin 的责任，而是开发工作流的一部分。把 air 加进 Makefile 或 IDE 的 Run Configuration，比纠结 “Gin 怎么不自动 reload” 实用得多。另外，上线前务必确认 LoadHTMLGlob 路径是相对可执行文件的，不是相对 main.go —— 这个路径问题在线上环境爆出来的概率远高于本地。
