beego模板本质是启动时编译缓存，非运行时拼接；所有模板在启动时解析为template.Template实例并缓存，后续仅执行渲染；不支持动态生成模板文件，仅可组织已有模板与注入逻辑。
beego 的模板生成本质是编译缓存，不是运行时拼接
Beego 的模板引擎底层用的是 Go 标准库的 html/template，所有模板文件在应用启动时（或首次访问时，取决于是否启用开发模式）被一次性读取、解析、编译，并缓存在内存中。这意味着：views/ 下的每个 .html 或 .tpl 文件都会变成一个可执行的 template.Template 实例，后续渲染只是传入数据并执行。
这个机制决定了它不适合做“动态生成模板文件”的场景——比如根据用户角色实时写入一个新 .html 到磁盘再加载。你真正能定制的，是「如何组织已有模板」和「如何注入逻辑」。
- 开发模式下（
runmode = dev），每次请求前会检查模板文件修改时间，自动重编译；生产环境则只编译一次，不监听变化 - 模板路径由
beego.ViewsPath控制，默认为"views"，只能设为单个目录，不支持多级搜索路径 - 若模板文件名含非法字符（如空格、中文路径），编译会失败，错误信息类似：
parse "views/index .html": invalid character " " in text
自定义函数必须在 beego.AddFuncMap 中注册，且仅限全局作用域
你在 controller 里写的 func(in string) string 不会自动生效。必须在 main() 启动前，用 beego.AddFuncMap 显式注册，否则模板里调用 {{.content|lower}} 会报错：error calling lower: function "lower" not defined。
常见错误是把注册语句写在路由注册之后，或写在某个 controller 的方法里——这都无效。正确位置只有一处：main() 函数开头、beego.Run() 之前。
- 函数签名必须严格匹配：第一个参数是输入值，返回值是处理后结果，不能有额外参数或 error 返回
- 函数名作为模板中调用的标识符，区分大小写；
{{.s|Lower}}和{{.s|lower}}是两个不同函数 - 不支持闭包或带状态的函数，例如无法在函数里访问 session 或 db 连接
TplName 和 Layout 的组合决定最终输出结构
Beego 渲染流程是：先渲染 TplName 指向的模板，再将其结果填入 Layout 模板中定义的 {{template "content" .}} 占位处。两者是嵌套关系，不是并列包含。
如果你只设了 c.TplName = "user/profile.html" 而没设 c.Layout，那就走纯模板渲染；一旦设了 c.Layout = "layout/base.html"，就必须确保 layout 文件里有 {{template "content" .}}，否则子模板内容不会出现。
-
LayoutSections是可选增强项，用于拆分 header/footer 等片段，但每个 section 名称必须在 layout 中用{{template "Header" .}}显式引用，否则会被忽略 -
TplName路径是相对于ViewsPath的，写成"admin/user.tpl"就对应views/admin/user.tpl，不能写绝对路径 - 如果
TplName文件不存在，Beego 不报错也不提示，而是静默 fallback 到默认命名规则（如controllername/actionname.html），容易误判问题根源
模板标签冲突时改 TemplateLeft/TemplateRight，但别滥用
当你的前端用 Angular、Vue 或某些 JS 框架，而它们也用 {{}} 做插值语法，就会和 Beego 模板冲突。这时可以改左右定界符，比如：
beego.TemplateLeft = "<<" beego.TemplateRight = ">>"
改完后模板里就得写 <<.name>>，而不是 {{.name}}。但注意：这会影响所有模板，包括你引入的第三方模板片段，且无法按文件粒度开关。
- 修改必须在
main()中beego.Run()之前完成，否则无效 - 不建议改成
{% %}或[[ ]]等非标准符号，因为 Go 的text/template解析器只认配对的字符串，且部分符号可能被 HTML 或 JS 解析器提前截断 - 更轻量的替代方案是：对 JS 变量插值改用
ng-bind或v-text，避开双大括号，而非动框架层配置
最易被忽略的一点：模板编译缓存是按文件路径+内容哈希做的，但 LayoutSections 引用的子模板（如 header.html）如果被修改，Beego 不会自动检测其变更——除非你重启服务或手动清空缓存。开发中遇到 layout 更新但内容不刷新，先查这个。
