LoadHTMLGlob不支持多后缀通配符,因依赖的filepath.Glob不支持{.html,.tmpl}语法;正确方式是用filepath.WalkDir遍历目录并筛选后缀,再调用LoadHTMLFiles加载;同名模板需用{{define}}显式命名且路径严格一致。

LoadHTMLGlob 不支持多后缀通配符匹配
LoadHTMLGlob 底层依赖 Go 的 filepath.Glob,而该函数**不支持 `{.html,.tmpl,.gohtml}` 这类 shell 风格的多后缀语法**。你写 r.LoadHTMLGlob("templates/**/*.html") 只能匹配 .html,写 "templates/**/*.{html,tmpl}" 会静默失败——既不报错,也不加载任何模板,后续调用 c.HTML 时直接 panic:template: "xxx" is undefined。
正确做法:用 filepath.WalkDir + LoadHTMLFiles
必须自己遍历目录、筛选多个后缀,再传给 LoadHTMLFiles。这是 Gin 官方未封装但唯一可靠的方式:
- 用
filepath.WalkDir("templates", ...)递归扫描所有文件 - 对每个
fs.DirEntry判断是否为文件(!d.IsDir())且后缀在白名单中(如strings.HasSuffix(d.Name(), ".html") || strings.HasSuffix(d.Name(), ".tmpl")) - 收集到
[]string切片后,一次性传给r.LoadHTMLFiles(tplFiles...)
注意:LoadHTMLFiles 接收的是可变参数,所以调用时要加 ... 展开切片;路径必须是文件系统真实路径(相对路径以当前工作目录为准)。
模板名冲突时必须用 {{ define }} 显式命名
当不同目录下存在同名文件(比如 templates/user/index.html 和 templates/admin/index.html),c.HTML 仅靠文件名无法区分。此时:
- 必须在每个模板开头手动添加
{{ define "user/index.html" }}和{{ define "admin/index.html" }} -
c.HTML的第二个参数要写成"user/index.html",而非仅"index.html" - 不加
define就加载同名文件,Gin 会使用最后加载的那个,行为不可控
别踩 templates/** 这个坑
有人试过 r.LoadHTMLGlob("templates/**") 想“一劳永逸”,结果启动就 panic:html/template: pattern matches no files 或更糟的编译错误。因为 ** 在 Glob 中只匹配目录,不匹配文件;而空目录或非模板文件(如 .gitkeep)也会被纳入,导致解析失败。这个模式完全不可用,文档里没写,但实测就是雷。
实际项目里最麻烦的不是加载逻辑本身,而是模板名和 define 字符串必须严格一致——拼错一个斜杠或大小写,运行时才暴露,且错误提示极其模糊。建议把模板路径规则写进 Makefile 或构建脚本里固化下来。











