panic: html/template: pattern matches no files 的根本原因是 gin 以当前工作目录（os.getwd()）为基准查找模板，而非源码目录；需用 filepath.abs(filepath.dir(os.args[0])) 构造绝对路径并避免使用 ..。
panic: html/template: pattern matches no files 是路径没找对
这个 panic 表明 LoadHTMLGlob 或 LoadHTMLFiles 根本没找到任何模板文件，不是语法错、不是变量错，是连文件都没看见。核心原因永远是：Gin 查找模板用的是**当前工作目录（os.Getwd()）**，而不是源码所在目录或 main.go 所在目录。
常见踩坑点：
- 你执行
go run cmd/app/main.go时，工作目录是cmd/，但模板在templates/（与cmd/同级），LoadHTMLGlob("templates/*")就会失败 - IDE 默认在项目根目录运行，但 Docker 构建或 CI 脚本可能在子目录下执行
go build，路径行为不一致 -
filepath.Abs("templates/*")不等于filepath.Join(dir, "templates/*")，前者解析的是“当前工作目录下的 templates”，后者才是你想拼的绝对路径
正确做法是显式构造绝对路径：
dir, _ := filepath.Abs(filepath.Dir(os.Args[0])) r.LoadHTMLGlob(filepath.Join(dir, "..", "templates", "*"))
更稳妥的写法是把模板目录固定在 app.yaml 或二进制同级（尤其在 GAE 等受限环境），避免 .. —— 因为 GAE 明确禁止上级路径访问，.. 在那里永远返回空。
{{.Title}} 渲染成空或显示 {{.Title}} 原文
这是数据绑定失败，和模板加载无关。Gin 使用 Go 原生 html/template，它只认**导出字段**（首字母大写）。
如果你传了这样的结构体：
type Page struct {
title string // 小写 → 模板里永远是零值
}
c.HTML(200, "index.html", Page{title: "Home"})
那 {{.title}} 就是空，{{.Title}} 会报 nil pointer evaluating interface {}.Title。
必须改成：
type Page struct {
Title string // 大写 T
}
其他常见情况：
- 传了
map[string]interface{}，但 key 写成了"title"（小写），模板里却写{{.Title}}→ 键名必须完全一致 - 传了
nil指针（比如*Page(nil)），模板里直接{{.Title}}就 panic；要先判空：{{if .}}{{.Title}}{{end}} - 用了嵌套模板但没预定义，比如
{{template "header" .}}，但没在主模板顶部写{{define "header"}}...→ 模板执行时找不到命名模板
NoRoute() 里 c.HTML(404, "404.html", data) 还是白屏或 panic
Gin 的 NoRoute() 是兜底路由，但它不会自动加载模板——你得确保 "404.html" 已被 LoadHTMLGlob 或 LoadHTMLFiles 加载过，且路径和文件名完全匹配（包括大小写）。
典型问题：
-
LoadHTMLGlob("templates/*")加载了templates/404.html，但你在NoRoute里写c.HTML(404, "404.htm", ...)→ 文件名不一致，panic - 模板里用了
{{template "base" .}}，但"base"模板没被 glob 匹配到（比如它在layouts/base.html，而 glob 只写了"templates/*"）→ 执行时报template: "404.html": named template "base" not defined - 想在 404 页面显示请求路径，写了
{{.Request.URL.Path}}→ 模板里不能访问 Gin Context，必须提前提取：c.HTML(404, "404.html", gin.H{"path": c.Request.URL.Path})，然后模板里用{{.path}}
GAE 部署后模板全丢，本地却好好的
Google App Engine 标准环境有硬性沙箱规则：**只有 app.yaml 所在目录及其子目录对 Go 进程可见**，父目录（..）、同级目录（../templates）在部署后彻底不可访问。
你本地能跑，是因为 go run 不受 GAE 沙箱限制；部署后 filepath.Glob("../templates/*") 返回空切片，LoadHTMLGlob 就 panic。
必须重构项目结构，让所有资源收敛到 app.yaml 下方：
myapp/
├── app.yaml ← GAE 入口，唯一可信根目录
├── main.go
├── templates/
│ ├── index.html
│ └── 404.html
└── static/
└── style.css
然后加载时用相对路径：
r.LoadHTMLGlob("templates/*")
同时检查 app.yaml 的 static_dir 配置：如果写了 static_dir: ../static，GAE 会静默忽略该规则，还可能污染文件系统视图——必须改为 static_dir: static。
最隐蔽的坑是：即使你没配 static_dir，只要某条 url 规则通配范围太宽（比如 url: /.*），GAE 也可能把 templates/ 当作静态路径剥离掉。所以 GAE 上，路径即契约，结构不对，一切免谈。
