Gin的模板继承是基于Go标准库html/template的命名模板（define/template）机制模拟实现的，并非原生继承；主模板通过{{template "name" .}}预留区块，子模板用同名{{define "name"}}填充内容，加载时需统一解析所有相关模板，渲染时只调用主模板文件。
什么是 Gin 的模板继承机制
Gin 本身不提供类似 Django 或 Jinja2 的原生模板继承语法（如 {% extends %}、{% block %}），它底层用的是 Go 标准库的 html/template，而该包只支持通过 template.ParseFiles 和 {{ template "name" . }} 实现“模板组合”，不是严格意义上的继承。所谓“Gin 模板继承”，其实是靠手动定义命名模板 + 主模板调用实现的模拟效果。
如何用 define 和 template 搭建基础继承结构
关键在于主模板（如 layout.html）中定义可被覆盖的命名区块，子模板（如 index.html）通过 define 声明同名模板并填充内容，再由 Gin 渲染主模板时自动注入。
实操建议：
- 主模板
templates/layout.html必须包含至少一个{{ define "content" }}区块，并在合适位置调用{{ template "content" . }} - 子模板开头必须用
{{ define "content" }}（名字要和主模板中template调用的名称一致），结尾用{{ end }} - Gin 加载模板时需用
LoadHTMLGlob("templates/**/*")或LoadHTMLFiles("templates/layout.html", "templates/index.html")，确保所有相关模板都被解析进同一个template.Tree - 渲染时只调用主模板：
c.HTML(200, "layout.html", data)，不要传"index.html"
示例片段：
<!-- templates/layout.html -->
<!DOCTYPE html>
<html><body>
<header>我的站点</header>
<main>{{ template "content" . }}</main>
</body></html><!-- templates/index.html -->
{{ define "content" }}
<h1>首页内容</h1>
<p>这是子模板填充的部分</p>
{{ end }}为什么子模板单独渲染会空白或报错
常见错误现象：直接 c.HTML(200, "index.html", data) → 页面空白，或控制台报 template: "index.html" is an incomplete or empty template。
原因很直接：子模板只定义了 "content"，没输出任何顶层文本，Go 的 html/template 默认只渲染顶层模板内容（即未被 define 包裹的部分）。而 index.html 全部内容都在 {{ define "content" }} 里，所以渲染它等于什么都没输出。
解决办法只有两个：
- 始终用主模板名（如
"layout.html"）作为c.HTML的第一个参数 - 确保所有子模板都通过
define命名，且名字与主模板中{{ template "xxx" . }}的字符串完全一致（大小写敏感）
如何支持多级嵌套和动态区块（比如 SEO 标题、侧边栏）
可以定义多个命名模板，不只是 "content"。例如：
- 在
layout.html中预留{{ template "title" . }}、{{ template "sidebar" . }}、{{ template "footer" . }} - 每个子模板按需
define "title"或跳过（跳过则主模板中该位置为空） - 如果某个区块有默认内容，可在
layout.html中写成：{{ template "title" . }}{{ if not (eq (index . "title") "") }}{{ else }}默认标题{{ end }}，但更推荐用数据字段控制，比如{{ .PageTitle }} - 注意：所有
define必须在同一个模板集合内可见，不能跨ParseFiles调用隔离
性能上无额外开销，Go 模板编译后是静态结构；兼容性也无问题，纯标准库能力。
最容易被忽略的一点：模板文件路径里的斜杠方向在 Windows 下容易写错（比如用了反斜杠），导致 LoadHTMLGlob 漏掉子模板，结果 template "content" 找不到定义 —— 最好统一用正斜杠或 filepath.Join 构造路径。
