Gin调用c.HTML前必须显式加载所有继承相关模板，否则报“template is undefined”错误；需用LoadHTMLGlob("templates/*/")或LoadHTMLFiles明确注册base与子模板，且{{template}}引用名须与文件路径注册名完全一致。
c.HTML 调用前必须完成模板加载和继承定义，否则会 panic：`template: "xxx" is undefined` —— 这是最常见的失败点，不是语法写错了，而是模板没被 Gin 看到。
如何正确加载支持继承的模板文件
Gin 本身不提供“自动解析继承关系”的能力，它只负责把LoadHTMLGlob 或 LoadHTMLFiles 扫到的文件注册进内部 template.Tree。继承能否工作，取决于你是否把所有参与继承的模板（base、child、partial）都显式加载了。
常见错误是只加载子模板，漏掉 base 模板：
-
r.LoadHTMLGlob("templates/article/*.html")→ 只加载 article 下的文件，base.html不在路径内，{{template "main" .}}就会报错 - 正确做法是统一加载整个模板树：
r.LoadHTMLGlob("templates/**/*")，或明确列出：r.LoadHTMLFiles("templates/base.html", "templates/article/index.html") - 注意路径分隔符：Windows 下
filepath.Join比硬写\更可靠；Linux/macOS 必须用/
base.html 中 define 和 template 的配对规则
Gin 使用 Go 标准库html/template，继承靠的是 {{define "name"}}...{{end}} + {{template "name" .}}。名字必须完全一致，且大小写敏感。
典型结构：
-
base.html定义骨架和可替换区块：{{define "title"}}Default Title{{end}}、{{define "content"}}{{end}} -
article/index.html通过{{template "base.html" .}}引入基础模板，再用{{define "content"}}...{{end}}覆盖内容区块 - 不能在子模板里重复
define "base.html"—— 这会导致解析失败，base 模板名只是文件路径标识，不是区块名 - 如果 base 里用了
{{block "sidebar" .}}{{end}}，子模板中必须用{{define "sidebar"}}...{{end}}，block和define不可混用
为什么 c.HTML 找不到子模板里的 define？
根本原因是：Gin 在调用c.HTML 时，只会查找**第一个参数指定的模板名**（如 "article/index.html"），然后执行它。这个模板内部的 {{template "xxx" .}} 是运行时行为，依赖于所有被引用的模板（如 "base.html"）**已预先加载并命名注册**。
关键细节：
- Gin 加载模板时，会把每个文件按其相对路径作为模板名注册（如
templates/base.html→ 模板名"base.html"） - 所以子模板里写
{{template "base.html" .}}才能命中；写{{template "base" .}}会失败 - 可以用
r.SetHTMLTemplate(t *template.Template)手动传入一个预构建好的*template.Template，此时命名完全由你控制，但需自行处理嵌套 parse - 调试技巧：启动前加
fmt.Println(r.Delims)和log.Fatal(r.Run())查看 panic 堆栈，90% 的继承失败会在这一行炸出来
静态资源路径与模板继承的耦合问题
模板继承本身不涉及静态文件，但实际项目中，base.html 通常包含 <link href="/static/css/app.css"> 这类引用。这时必须确保 r.Static("/static", "./statics") 在 r.LoadHTMLGlob 之前调用。
否则会出现：
- 页面 HTML 渲染成功，但浏览器控制台报 404：/static/css/app.css
- 原因：Gin 路由匹配顺序是「先静态路由，再 API 路由」，如果
Static没注册，请求会被 fallback 到 404 handler - 额外陷阱：若你用
r.StaticFS("/static", http.Dir("./statics"))，注意http.Dir路径必须是绝对路径，相对路径在某些工作目录下会失效
LoadHTMLGlob 的 glob 模式和文件实际存放位置的映射关系。改个目录名、少加一个 *、多写一个 .，都可能导致 base 模板“存在但不可见”。 
