Gin中正确加载HTML模板需区分LoadHTMLFiles（显式指定路径，不递归）和LoadHTMLGlob（支持通配符，推荐templates/*/ .html），路径以工作目录为基准，c.HTML模板名须与文件名完全一致，首次渲染才编译模板。
r.LoadHTMLFiles 和 r.LoadHTMLGlob 是 Gin 解析模板文件的唯二入口，选错就直接报 template: "xxx.html" is undefined —— 这不是代码写错了，是模板压根没被加载进引擎。
LoadHTMLFiles：只认明确列出的文件路径
它不会递归、不支持通配符，传进去什么路径，就只加载那个文件（或那几个文件）。适合模板数量少、结构扁平、路径固定的情况。
- 路径必须存在且可读，相对路径以当前工作目录为基准（不是
main.go所在目录） - 多个文件要全写出来：
r.LoadHTMLFiles("templates/index.html", "templates/about.html") - 如果文件在子目录里，必须带完整路径：
"templates/user/profile.html"，不能只写"user/profile.html" - 重复调用会覆盖之前加载的模板，不会合并
LoadHTMLGlob：靠 glob 模式匹配，但注意双星号行为
r.LoadHTMLGlob("templates/**/*") 看起来能扫所有嵌套 HTML，但 Go 的 filepath.Glob 实现对 ** 并不原生支持——Gin 内部做了兼容处理，但仅限于 ** 出现在路径中间且前后都有斜杠（如 "templates/**/*.html"）才真正递归；"templates/**/*" 在某些 Go 版本下可能只扫一层。
- 推荐写法：
r.LoadHTMLGlob("templates/**/*.html")或r.LoadHTMLGlob("templates/*.html") - Windows 下路径分隔符不影响，Gin 会自动 normalize
- 匹配到的文件必须是合法的
html/template格式，比如含未闭合的{{会导致整个加载失败，且错误提示极简（常只报parse error）
c.HTML 渲染时找不到模板的三个常见原因
加载了≠能用。渲染阶段出错往往和加载逻辑无关，而是运行时上下文问题。
- 传给
c.HTML的模板名（第二个参数）必须和文件名完全一致，包括大小写和扩展名："index.html"不能写成"index"或"Index.html" - 如果用了嵌套模板（
{{template "header" .}}），被引用的子模板名（如"header"）必须在同一个加载批次中，且定义在被调用模板之前，否则 panic -
gin.H{}或结构体字段名首字母必须大写（导出），否则模板里{{.Title}}取不到值，静默为空字符串
模板解析失败时 debug 的实际手段
别只看控制台有没有 panic —— Gin 默认不打印模板 parse 错误，除非你手动捕获并打印。
- 启动前加一行：
gin.SetMode(gin.DebugMode)，能让部分加载错误更早暴露 - 加载后立刻测试解析：
tmpl, _ := r.HTMLRender.(*render.HTMLRender).Engine.Lookup("index.html")，检查tmpl是否为nil - 把模板文件临时改成纯文本（比如删掉所有
{{），再访问路由，如果还报错，说明是路径/加载问题；如果能显示纯文本，说明是模板语法问题
最易忽略的一点：Gin 的模板引擎在首次 c.HTML 调用时才真正编译模板，不是 LoadHTMLFiles 那一刻。所以即使加载成功，语法错误也会拖到第一次渲染才爆发，且错误堆栈指向 Execute 而非 Load —— 这让定位变难。
