LoadHTMLGlob通配符路径必须正确，如"templates/*/.html"才可递归匹配；模板名仅为文件basename，不支持斜杠路径；多目录需重命名或显式注册；编译后templates须与二进制同级。
LoadHTMLGlob 通配符路径必须写对，否则子目录模板根本不会注册
很多人以为 LoadHTMLGlob("templates/**/*") 能扫全所有 HTML 文件，但实际效果取决于目录结构和通配符语义。Gin 的 glob 实现基于 Go 标准库的 filepath.Glob，其中 ** 并非递归通配符——它只是被 Gin 内部特殊处理为“多级子目录”，但前提是路径末尾不能是 ** 单独存在。
常见错误写法：
-
r.LoadHTMLGlob("templates/**")→ 会尝试加载目录本身，编译时报template: "xxx" is undefined或静默失败 -
r.LoadHTMLGlob("templates/*/*.html")→ 只匹配一层子目录，漏掉templates/article/detail.html这类两层嵌套 -
r.LoadHTMLGlob("templates/**/*.html")→ 正确，能覆盖templates/index.html和templates/search/detail.html
开发期建议加一行日志确认：log.Println("loaded templates:", "templates/**/*.html")，避免误判路径是否生效。
模板名不是文件路径，而是注册时的 basename（不含扩展名）
调用 c.HTML(200, "search/detail", data) 是错的——Gin 不支持斜杠分隔的模板名。无论你把 detail.html 放在 templates/search/ 还是 templates/ 下，注册后它的模板名都是 "detail"，冲突时后加载的会覆盖前一个。
立即学习“go语言免费学习笔记（深入）”；
所以多目录场景下必须手动控制命名空间：
- 用
LoadHTMLFiles显式传入带前缀的路径：r.LoadHTMLFiles("templates/index.html", "templates/search/detail.html")，此时模板名就是"index"和"detail"，仍可能重名 - 更稳妥的是统一重命名：把
templates/search/detail.html改成templates/search_detail.html，再用LoadHTMLGlob("templates/*_*.html")加载，模板名即为"search_detail" - 若必须保留目录结构语义，推荐用
filepath.WalkDir遍历 +strings.TrimPrefix(path, "templates/")构造唯一模板名，再逐个LoadHTMLFiles
c.HTML() 第二个参数必须与注册的模板名完全一致，大小写敏感且无扩展名
哪怕只差一个字母或大小写，Gin 就会返回空白页，不报错也不打日志——这是最常被忽略的静默失败点。
典型问题现象：
- 模板文件叫
Index.html，却传"index"→ 渲染为空 - 数据结构字段是
Title，模板里写{{.title}}→ 输出空字符串（字段不可导出） - 传了
gin.H{"Title": "Home"}，但模板里写{{.title}}→ 拿不到值（键名不匹配）
验证方法：启动服务后，访问任意路由前先打印 r.Delims 和内部 template map（需反射或调试），但更简单的是加个兜底路由：r.GET("/debug/templates", func(c *gin.Context) { c.JSON(200, r.HTMLRender.(*gin.HTMLRender).Templates.Templates()) })，直接看哪些名字被注册进去了。
编译后二进制运行时，templates/ 必须和可执行文件同级
Go 编译生成的 ./myapp 默认只认自己所在目录下的 templates/，不管源码在哪、go run 从哪执行。很多人本地 go run main.go 成功，一打包部署就白屏，就是这个原因。
部署时务必检查：
- 打包脚本是否把
templates/目录完整复制到二进制同级（不是嵌套在某个子目录里） - 容器镜像中，
COPY ./templates /app/templates和WORKDIR /app是否配套 - 如果用 systemd 启动，
WorkingDirectory=配置是否指向二进制所在目录
临时调试可用 os.Chdir() 强制切换工作目录，但上线前必须删掉——它会干扰其他依赖当前路径的逻辑。
