Go模板中子模板必须先define后template调用；ParseFiles参数顺序不影响定义合并，但推荐ParseGlob；传参需明确作用域，优先用block实现嵌套覆盖；热更新需原子替换模板实例。
template.ParseFiles 无法加载子模板？检查 define 和 template 的顺序
Go 的 html/template 要求所有被 template 调用的子模板，必须在调用前已定义——不是文件加载顺序，而是解析后模板树中的定义顺序。常见错误是：主模板里写了 {{template "header"}}，但 ParseFiles 加载时把 header.html 放在了后面，导致运行时报 template: "header" is undefined。
解决办法只有一个：统一用 ParseGlob 或手动合并解析。比如：
tmpl := template.New("base").Funcs(funcMap)
tmpl, _ = tmpl.ParseFiles("layout.html", "header.html", "footer.html") // 顺序无关，因为 ParseFiles 内部会收集全部 define
// ✅ 更稳妥：用 ParseGlob 并确保子模板文件名不被主模板覆盖
tmpl, _ = template.ParseGlob("templates/*.html")
-
ParseFiles会按参数顺序逐个解析，但最终把所有define合并进同一个*template.Template实例，所以只要文件都传进去了，顺序其实不影响引用（但别依赖这点） - 如果用
template.Must(template.New("x").ParseFiles(...))，且某个文件语法错，整个解析失败，错误位置难定位——建议分步解析 + 日志 - 子模板文件名无需和
define名一致；{{define "nav"}}可以写在menu.html里，完全合法
嵌套时 {{template}} 传参不生效？确认是否用了 . 或命名管道
子模板接收数据靠的是当前作用域（.），不是自动继承父模板变量。很多人写 {{template "sidebar" .User}}，却在 sidebar.html 里直接用 {{.Name}}，结果空指针 panic——因为 .User 是传进去的值，子模板的 . 就是它，但如果你没在子模板里显式用 .，而是误以为能访问父级的 .Page.Title，那就错了。
正确做法只有两种：
立即学习“go语言免费学习笔记（深入）”；
- 传结构体指针或 map：
{{template "sidebar" .User}}→ 子模板中{{.Name}}有效 - 传整个上下文再局部取：
{{template "sidebar" .}}→ 子模板仍可访问{{.Page.Title}} - 用
with配合命名管道更清晰：{{with .User}} {{template "sidebar" .}} {{end}}，避免歧义
注意：{{template "x" $v}} 中的 $v 必须是非 nil 值，nil 传进去会导致子模板内 . 为 nil，{{if .Name}} 不报错但永远 false，容易漏掉逻辑分支。
多层嵌套下 block 和 define 混用导致内容丢失？优先用 block 替代 template
当你有 layout.html 定义骨架、page.html 继承它、再想让 page.html 中某区块被 content.html 覆盖时，若全用 template，会因执行顺序和作用域丢失内容。典型症状：页面渲染出来，{{template "main"}} 那块完全空白，控制台也没报错。
根本原因是 template 是“调用即执行”，不支持回填；而 block 是“声明+覆盖”机制，天然适合嵌套布局：
- layout.html 里写
{{block "content" .}}默认内容{{end}} - page.html 里写
{{define "content"}}<h1>{{.Title}}</h1>{{end}} - 解析时用
tmpl.ParseFiles("layout.html", "page.html")，block会自动合并覆盖 -
block可以嵌套：子模板里的{{block "sidebar" .}}{{end}}也能被更低层覆盖
性能上无差异，但 block 更安全——它不依赖文件加载顺序，也不怕重复 define，后定义的自动覆盖前一个。
生产环境热更新嵌套模板？别直接 reload template，用惰性重解析
开发时改完 header.html，希望浏览器刷新就看到效果，但 Go 模板对象不可变，ParseFiles 返回新实例，老实例还在服务请求。硬 reload 会导致并发 panic（concurrent map read and map write），尤其用了 Funcs 注册函数时。
- 不要在 handler 里每次调用
template.ParseFiles——太慢，且无缓存 - 用 sync.RWMutex + 指针包装模板实例，只在文件变更时替换指针指向的新实例
- 更简单：用
fsnotify监听templates/目录，触发时重建整个*template.Template，然后原子替换 - 注意：
template.New创建的根模板名必须唯一，否则ParseFiles会覆盖已有同名模板，引发意外覆盖
最易忽略的一点：子模板里用 {{template "x"}} 引用的名称，和你 ParseFiles 时传入的文件名毫无关系——只和 define 里的字符串字面量有关。改文件名不等于改模板名，别被表象骗了。
