模板路径必须用绝对路径，推荐基于main.go位置动态计算；多级目录需用filepath.WalkDir+LoadHTMLFiles并显式define模板名，静态资源须单独注册Static路由。
模板路径必须用绝对路径，不能依赖工作目录
运行 go run main.go 时，router.LoadHTMLGlob("templates/*") 查找的是当前 shell 所在目录下的 templates/，不是 main.go 所在目录——这意味着从项目外执行、CI 构建、IDE 右键运行都可能失败，直接 panic：html/template: pattern matches no files。
正确做法是用 filepath.Abs 动态算出模板目录位置：
wd, _ := os.Getwd() tmplDir := filepath.Join(wd, "templates") // 更稳妥：基于 main.go 文件位置（避免被 cd 影响） _, filename, _, _ := runtime.Caller(0) tmplDir := filepath.Join(filepath.Dir(filename), "templates")
- 硬编码路径（如
"./templates/*"）在跨环境时极易失效 - 不检查
os.Stat(tmplDir)就调用LoadHTMLGlob，错误会延迟到首次访问路由才暴露 - Windows 和 Linux 路径分隔符差异由
filepath.Join自动处理，别手拼"templates\"或"templates/"
多级子目录模板必须用 LoadHTMLFiles + filepath.WalkDir
LoadHTMLGlob("templates/**/*") 看似能递归加载，但 Gin 的 glob 实现不支持双星号通配（尤其在 Go 1.16+ 后更严格），实际只匹配一层或直接 panic。真正可靠的方式是手动遍历文件树再传给 LoadHTMLFiles。
示例代码片段：
var tplFiles []string
_ = filepath.WalkDir("templates", func(path string, d fs.DirEntry, err error) error {
if !d.IsDir() && strings.HasSuffix(d.Name(), ".html") {
tplFiles = append(tplFiles, path)
}
return nil
})
router.LoadHTMLFiles(tplFiles...)
- 模板名在
c.HTML()中仍用相对路径（如"admin/dashboard.html"），无需去掉templates/前缀 - 若不同子目录下存在同名文件（如
users/index.html和posts/index.html），必须在模板内用{{ define "users/index.html" }}显式声明，否则渲染时会冲突 -
LoadHTMLGlob("templates/*")仅适用于纯扁平结构，一旦有子目录就不可靠
静态资源（CSS/JS/图片）必须单独注册 Static 路由
HTML 模板里写的 <link href="/css/app.css"> 是浏览器发的 HTTP 请求，和模板加载完全无关。Gin 默认不提供任何静态文件服务，不注册就会 404。
假设 CSS 放在 templates/css/ 目录下，对应写法是：
router.Static("/css", "./templates/css")
-
Static第一个参数是 URL 前缀（浏览器看到的路径），第二个是磁盘上的物理路径（相对于当前工作目录） - 别把模板目录和静态资源混放——
templates/只该放 .html/.tmpl；CSS/JS 应该放在static/css/这类独立目录，然后router.Static("/static", "./static") - 如果用了
LoadHTMLFiles加载模板，静态路径注册不受影响，两者完全解耦
c.HTML() 的模板名解析规则容易误判
传给 c.HTML(200, "index.html", data) 的字符串，不是文件系统路径，而是模板定义名。Gin 会按以下顺序匹配：
- 先查模板文件中是否用
{{ define "xxx" }}显式定义了该名字 - 如果没有
define，则 fallback 到文件名（不含路径，只取basename） - 所以
templates/user/login.html和templates/admin/login.html若都没加define，都会被识别为"login.html"，后者会覆盖前者
结论：只要目录结构含多级，就必须在每个模板开头加 {{ define "user/login.html" }} ——这不是可选项，是避免运行时覆盖的必要操作。
最易忽略的一点：模板定义名必须和 c.HTML() 传入的字符串**完全一致**，包括大小写和扩展名，且不能带多余空格。
