必须启动时用parseglob一次性加载全部模板，否则各模板实例孤立无法互相引用；并发parsefiles会触发竞态且性能差；局部模板需显式{{define}}命名，主模板用{{template "name" .}}调用。
直接在每次 HTTP 请求里用 template.ParseFiles 加载多个局部模板（比如 header.html、sidebar.html、footer.html）再拼接，性能差、易出错、无法共享定义——这不是动态合并，是重复造轮子。
为什么不能每次请求都 ParseFiles 多个局部模板
Go 的 html/template 不支持跨模板实例引用：{{template "header"}} 只能在同一个 *template.Template 实例里生效。如果每个 handler 都调用 template.ParseFiles("header.html", "sidebar.html")，得到的是三个孤立的模板对象，彼此不认识对方定义的 {{define}} 块。
- 并发下可能触发竞态：多个 goroutine 同时调用
ParseFiles修改全局模板状态 - 磁盘 I/O + 语法解析反复发生，QPS 下降明显（实测 100+ 模板时单次请求多花 2–5ms）
-
template.Execute传入的数据上下文无法自动穿透到被{{template}}引用的子模板，除非显式传递.
必须用 ParseGlob 预加载全部局部模板
启动时一次性加载所有 .html 文件，让它们共存于同一个模板集合中，才能互相引用。
- 路径必须统一，例如全部放在
templates/目录下，且文件名不冲突（header.html、sidebar.html、dashboard/content.html都可被识别） - 每个文件必须用
{{define "xxx"}}显式命名，不能靠文件名自动推导（header.html里写{{define "header"}}，否则{{template "header"}}找不到） - 避免使用
template.Must(template.New("xxx").ParseFiles(...))—— 这会创建新实例，破坏全局共享
正确初始化方式：
var templates = template.Must(template.ParseGlob("templates/**/*.html"))
注意双星号 ** 支持子目录递归匹配（Go 1.16+），旧版本请改用多个 ParseGlob 或手动列举。
在 Golang 中使用 samber/hot 进行内存缓存，支持 LRU、LFU、TinyLFU、W‑TinyLFU、S3FIFO、ARC、TwoQueue、SIEVE、FIFO 等淘汰算法，提供 TTL、缓存加载器及分片功能。
如何安全地把局部模板渲染结果注入主模板
直接 {{template "header" .}} 是最简方式，但前提是“header”已在同一模板集里定义；若需运行时决定渲染哪个局部模板（比如根据路由选 user/profile.html 或 user/settings.html），就得用 template.HTML 中转。
- 先用
bytes.Buffer渲染局部模板到内存，再转成template.HTML类型传给主模板——这样能绕过自动转义，且内容已完全渲染完毕 - 不要用字符串拼接 HTML 片段，否则
会被转义成 <code><，页面显示为源码 - 主模板里接收字段必须是
template.HTML类型，不能是string，否则仍会转义
示例数据结构：
type Page struct {
Title string
Body template.HTML // ← 必须是这个类型
}
handler 中构造：
var buf bytes.Buffer
err := templates.ExecuteTemplate(&buf, "user/profile.html", userData)
if err != nil { /* handle */ }
page := Page{
Title: "Profile",
Body: template.HTML(buf.String()),
}
templates.ExecuteTemplate(w, "base.html", page)
嵌套层级深时容易忽略的逃逸点
当局部模板本身又 {{template}} 引用了更底层的片段（比如 sidebar.html 里调用 {{template "search-bar"}}），所有被引用的模板块名必须全局唯一，且都在同一个 ParseGlob 加载范围内。
- 两个不同文件里定义同名
{{define "header"}}，后加载的会覆盖前一个，无警告 - 如果某个局部模板依赖另一个未被
ParseGlob匹配到的文件（比如漏掉templates/partials/*.html），运行时报错template: "xxx" is not defined -
ExecuteTemplate第二个参数是模板名（"user/profile.html"错误！应为"profile"），不是文件路径——它只认{{define}}里的名字
真正难调试的不是语法，而是模板名作用域和加载时机的隐式耦合。一旦漏掉一个 {{define}} 或错配路径，错误只在特定路由触发，且堆栈不指明哪行定义缺失。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
