正确引用命名子模板需确保其与主模板同属一个*template.Template实例，使用ParseGlob加载所有含{{define}}的文件，引用时用{{template "name" .}}传参，并通过ExecuteTemplate("name", data)显式渲染。
Go 语言没有官方框架，但用 html/template 就能实现接近框架级的模块化模板管理——关键不在“框架”，而在怎么组织 {{define}} 和 {{template}}，以及如何让局部内容安全、可控地注入到布局中。
如何用 {{template}} 正确引用命名子模板
命名模板必须和引用它的模板在同一个 *template.Template 实例里，否则运行时 panic：template: "main" is undefined。
- 用
template.ParseGlob("templates/*.html")</li> <li>所有文件里用 <code>{{define "header"}}、{{define "sidebar"}}定义，不能只在某个文件里定义却指望其他文件自动识别 - 引用时必须传参，比如
{{template "header" .}}（把当前数据上下文传过去），或{{template "header" $}}（显式传递根数据） - 如果子模板需要局部数据（比如只渲染一个按钮状态），可构造 map 或匿名 struct 作为 pipeline：{{template "button" (dict "Type" "primary" "Text" "提交")}}
template.ExecuteTemplate 和 Execute 的区别与选型
Execute 渲染的是模板集里的「默认模板」（即第一个被 Parse 的模板），而 ExecuteTemplate 显式指定要执行哪个命名模板——后者才是局部渲染的正确入口。
- 错误写法：
t.Execute(w, data)可能意外渲染了 base.html 本身，而不是你想要的index模板 - 正确写法：
t.ExecuteTemplate(w, "index", data)，确保只执行{{define "index"}}块 - 注意：如果
"index"模板内部又{{template "header" .}}，那 header 会按定义顺序被找到并执行，无需额外注册
避免 ParseGlob 加载失败的三个常见坑
template.ParseGlob 看似方便，但路径错一点就静默失败或 panic，尤其在跨平台或构建部署时。
立即学习“go语言免费学习笔记（深入）”；
- 路径必须是相对或绝对路径，且以 Go 进程当前工作目录为基准，不是
main.go所在目录 —— 建议统一用filepath.Join("templates", "*.html")并配合os.Chdir或硬编码绝对路径 - glob 不匹配任何文件时，
ParseGlob返回 nil error，但模板集为空；后续ExecuteTemplate会报template: "xxx" is undefined—— 务必检查len(t.Templates())是否 > 0 - Windows 下路径分隔符反斜杠可能干扰 glob 解析，一律用正斜杠或
filepath.ToSlash标准化
局部模板如何安全传入 HTML 片段
想让子模板渲染一段已转义的 HTML（比如富文本内容），不能直接 {{.Content}}，否则会被二次转义；也不能无脑用 {{.Content | safeHTML}}，除非你 100% 信任来源。
- 推荐方式：在 Go 层预处理，把原始 HTML 包进
template.HTML类型字段，例如：data := struct{ Content template.HTML }{template.HTML(rawHTML)} - 模板中直接写
{{.Content}}即可原样输出，html/template识别该类型后跳过转义 - 切勿在模板里用
{{.Raw | htmlUnescape}}之类自定义函数绕过安全机制 —— 这等于主动打开 XSS 门
真正难的不是语法，而是每次新增一个 {{define}} 时，要同步确认它是否被 ParseGlob 加载、是否被某个主模板显式 {{template}} 引用、参数结构是否和调用处一致——这三者缺一不可，漏一个就只能靠日志和 panic 信息倒推。
