Beego模板嵌套基于Go标准库html/template，layout通过this.Layout指定路径并由{{template "content" .}}注入内容，需显式定义{{define "content"}}；局部模板用{{define}}和{{template}}复用，文件须在views/下且命名一致，开发模式需确保路径正确、后缀注册及glob扫描覆盖。
Beego 的模板嵌套和布局不是靠框架特有语法驱动的，而是直接复用 Go 标准库 html/template 的能力，所以关键不在“学 Beego 怎么写”，而在“理解 template.New、template.Lookup、{{define}} 和 {{template}} 怎么配合工作”。
Beego 中 layout.html 是怎么被识别并插入内容的
Beego 并不自己解析 layout 文件，它只是在调用 Render() 前，把 this.Layout 指定的文件路径传给 Go 模板引擎，并把当前模板（this.TplName）作为数据注入到 layout 的 {{template "content" .}} 位置。
- 必须在 layout 文件里显式定义
{{define "content"}}，否则{{template "content" .}}找不到目标，会静默失败或报template: content is undefined -
this.Layout = "admin/layout.html"中的路径是相对于views/目录的，不是绝对路径；如果 layout 放在views/common/下，就得写this.Layout = "common/layout.html" - layout 文件本身不能直接被
display()渲染——它没有{{define "content"}}，也没有独立上下文，强行渲染会 panic
如何安全地复用 header / footer 等局部模板（partials）
Beego 没有 render_partial 这类方法，但你可以用 {{template}} 加 {{define}} 实现完全等效的效果，且支持传参。
- 局部模板文件（如
views/common/header.tpl）需以{{define "header"}}开头，结尾用{{end}} - 在主模板中用
{{template "header" .}}调用，.是当前上下文；若要传子集数据，可构造 map：{{template "header" (dict "title" .PageTitle "user" .CurrentUser)}}（注意：Go 原生模板不支持dict，需在 controller 中预构造好 map 并塞进this.Data） - 避免循环引用：不要在
header.tpl里再{{template "header" .}}，Go 模板会 panic 报template: loop detected - 局部模板文件不会被自动加载——只要没被
{{template}}引用，Beego 就不会解析它，所以命名随意，但推荐统一后缀（.tpl或.html）并放在views/common/下便于管理
为什么修改了 layout.html 却看不到变化
开发模式下 Beego 默认每次请求都重新解析模板，但这个行为只对 this.TplName 指向的主模板生效；{{template}} 引用的 layout 和 partials 文件，如果没被主模板显式 ParseFiles 过，就可能被缓存或跳过重载。
- 确认
beego.BConfig.RunMode == "dev"，否则模板缓存不会自动失效 - 确保 layout 和 partials 文件都在
views/目录下，且路径拼写与{{template}}中的一致（大小写敏感，尤其在 Linux/macOS 上） - 如果用了自定义模板后缀（比如
.tmpl），必须提前调用web.AddTemplateExt(".tmpl")，否则 Beego 根本不会扫描这些文件 - 最简单验证方式：临时在 layout 文件里加一行
DEBUG-{{now}}，看是否刷新——若不刷新，说明文件根本没被加载
controller 里设置 this.LayoutSections 的真实作用
this.LayoutSections 是 Beego 提供的一个快捷映射机制，本质是把字符串路径转成模板名，然后在 layout 中用 {{template "Header" .}} 替代硬编码路径，但它不解决模板加载逻辑，只简化写法。
- 你写
this.LayoutSections["Header"] = "common/header.html"，Beego 就会在渲染时自动把"common/header.html"解析为模板名"common/header.html"（注意：不是common/header） - 对应的 layout 文件里必须写
{{template "Header" .}}，而不是{{template "common/header.html" .}} - 这个机制依赖 Beego 自动调用
template.ParseGlob扫描所有views/下的文件，所以路径必须能被 glob 匹配到；如果 partial 放在views/_partials/这种带下划线的目录，可能被忽略 - 实际项目中，比起依赖
LayoutSections，更推荐直接在模板里用{{template "header" .}}+ 统一define，可控性更强，调试也更直观
真正容易被忽略的是：Beego 的模板系统从不校验 {{template}} 引用的目标是否存在，它只在执行 Execute 阶段才报错。这意味着 typo 写错一个字母，页面就白屏，控制台却无任何提示——务必在 layout 和 partials 文件名、define 名、template 调用名三者之间保持严格一致。
