Go 的 html/template 不支持原生模板继承，需通过 define/template 在同一 template 实例中解析所有相关文件实现；子模板仅定义块而不直接 Execute，父模板负责结构和调用；多子模板时应避免 define 冲突，可用唯一名或独立实例；block 提供 fallback 机制，比 define+template 更安全。
template.ParseFiles 无法识别 define 和 template 块？
Go 的 html/template 本身不支持“模板继承”语法（比如 Django 那种 {% extends %}），所谓“继承”其实是靠手动组合 define、template 和嵌套 ParseFiles 实现的。关键点在于：**所有用到的模板（父模板、子模板、块定义）必须在同一个 template.Template 实例中解析完成**，否则 template "xxx" 会报 template: xxx: "xxx" is not defined。
常见错误现象：ParseFiles("layout.html", "page.html") 后执行 Execute，但 page.html 里 {{template "content" .}} 找不到 "content" —— 因为 layout.html 里的 {{define "content"}} 没被当前 template 实例加载。
- 正确做法是统一用
template.New("").ParseFiles("layout.html", "page.html")或先New再链式ParseFiles - 顺序无关紧要，Go 会自动收集所有
define；但文件路径必须可读，且不能重复Parse同一内容（会覆盖） - 如果用
template.Must(t.Parse(...))，注意它返回的是原*template.Template，不是新实例
怎么让子模板只定义 content 而不重复渲染 layout？
核心是「分离职责」：父模板（如 layout.html）负责结构和占位，子模板（如 home.html）只用 define 填充具体块，**子模板本身不直接 Execute** —— 否则会把整个子模板当根内容渲染，导致 layout 丢失。
使用场景：你有统一头部/尾部，每个页面只变中间区域。这时子模板里写 {{define "content"}}<h1>首页</h1>{{end}}，然后在代码里 Execute 父模板，而不是子模板。
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 父模板
layout.html包含：{{template "header" .}} {{template "content" .}} {{template "footer" .}} - 子模板
home.html只含：{{define "content"}}<h1>首页</h1>{{end}}{{define "title"}}首页 - MyApp{{end}} - Go 代码中调用
t.Execute(w, data)的必须是包含layout.html的 template 实例，且已加载home.html
多个子模板共用 layout 时，如何避免 define 冲突？
define 是全局注册的，如果两个子模板都 {{define "content"}}，后解析的会覆盖前一个 —— 这不是 bug，是设计使然。但实际开发中常需要「每个页面独立定义 content」，这时候不能靠文件顺序硬控。
解决方案是：**用不同名字区分块，或用单模板多 define + 动态选择**。
- 推荐方式：子模板用唯一名，如
{{define "home-content"}}、{{define "user-profile-content"}}，layout 中用{{template .PageName "-content" .}}动态拼接（需在 data 中传PageName: "home"） - 更轻量方式：每个子模板只定义一个块（如
"content"），但用template.New("home").ParseFiles("layout.html", "home.html")为每个页面单独建实例 —— 内存开销略大，但逻辑最干净 - 注意：
template函数不支持变量名拼接（{{template $name .}}会报错），必须用with或预拼好字段
为什么 {{block}} 比 {{define}} + {{template}} 更安全？
block 是 html/template 提供的语法糖，本质是 define + template 的组合封装，但它自带 fallback 机制：如果子模板没重定义对应 block，就渲染父模板里写的默认内容。
容易踩的坑：{{block "header" .}}{{end}} 如果子模板没 {{define "header"}}，就会渲染空 —— 所以务必在 block 里写默认内容，比如 {{block "header" .}}<h2>默认标题</h2>{{end}}。
- 等价写法：
{{define "header"}}<h2>默认标题</h2>{{end}}{{template "header" .}}，但没 fallback 保护 -
block必须成对出现，且名称一致；它不能跨文件隐式继承，仍需同一 template 实例加载所有文件 - 性能上无差异，只是语义更明确，适合布局中那些“通常被覆盖、但允许兜底”的区域（如
title、meta）
真正复杂的地方在于加载时机和作用域隔离——一旦模板文件分散、解析分散、或混用 text/template 和 html/template，define 就会静默失效，debug 时得一层层 check template.Templates() 返回了哪些名字。
