必须先调用template.new("")再parsefiles，否则跨文件{{define}}不生效；{{template}}需显式传参如{{template "name" .}}，否则子模板收不到数据。
template.New("") 必须在 ParseFiles 前显式调用
Go 的 html/template 不支持跨实例的模板引用。如果你直接写 template.ParseFiles("layout.html", "page.html")，它会返回一个以第一个文件名为根的新实例，后续文件里的 {{define}} 不会被注册到全局模板树里——哪怕它们都在同一目录下。
报错现象通常是：template: "header" is not defined 或 template: "body" is not defined，哪怕 header.html 里明确定义了 {{define "header"}}。
- 正确写法是：
t := template.New("").ParseFiles("layout.html", "page.html") - 更稳妥的写法是：
t := template.Must(template.New("").ParseFiles("layout.html", "page.html"))，让 panic 在启动时暴露问题 - 用
ParseGlob("templates/**/*.html")更省心，所有匹配文件自动进同一实例，无需关心顺序 - 重复调用
ParseFiles会覆盖已有模板，不是叠加；想增量加载需自己管理*template.Template实例
{{template "name"}} 默认不传数据，必须显式写 {{template "name" .}}
嵌套模板不会自动继承主模板的数据上下文。如果主模板接收的是 gin.H{"title": "Home"}，而你在 layout.html 里写 {{template "content"}}，那么被调用的 content.html 拿到的是 nil，所有字段访问都会为空。
这不是 Gin 特有行为，是 html/template 底层机制决定的：每个 {{template}} 调用默认使用空上下文，除非你显式传入。
- 必须写成：
{{template "content" .}}（点代表当前上下文） - 若需局部修改上下文，可传子结构：
{{template "sidebar" .User}} - 用
{{block "name" .}}可替代{{define}} + {{template}}，它自带 fallback：没定义同名模板时，直接渲染 block 内容，不会 panic
Gin 中 LoadHTMLGlob 已隐式处理实例合并，但路径通配要小心
Gin 的 LoadHTMLGlob 内部会统一用 template.New("") 创建实例，并把所有匹配文件解析进去，所以你不用手动拼 ParseFiles。但它对路径通配符敏感，容易漏加载。
常见错误是写 router.LoadHTMLGlob("templates/*")，结果 templates/layout/base.html 没被包含——因为 * 不匹配斜杠。
- 多级目录必须用
**：router.LoadHTMLGlob("templates/**/*") - 推荐固定结构，比如统一放在
templates/下，再用LoadHTMLGlob("templates/*.html")避免歧义 - Gin 不支持运行时热重载模板，改了 HTML 文件需重启服务；开发期可用
fsnotify自行监听+重载
自定义渲染器里别直接 new template.Template，复用 Gin 的实例
如果你在 Gin 中实现自定义渲染器（比如加日志、加缓存、加元信息注入），不要在每次请求里 template.New("") 新建实例——这会导致模板重复解析，性能差且无法共享 define 定义。
Gin 的 engine.HTMLRender 是一个接口，底层已持有预解析好的 *template.Template 实例。你应该从 c.Engine.HTMLRender 获取并复用它。
- 错误做法：
t := template.New("").ParseFiles(...)放在 handler 里 - 正确做法：提前在
router.LoadHTMLGlob(...)后，通过router.SetHTMLTemplate(t)注入自定义实例 - 若需动态修改（如按用户角色切换 layout），建议用
{{template (printf "%s_layout" .Role) .}}，而非重建模板
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
