beego模板问题核心在于c.data传递机制、{{template}}路径规则和setviewspath时机；必须显式配置路径与后缀，结构体字段需大写，$用于访问根上下文，{{template}}路径须相对于views目录，setviewspath必须在beego.run()前调用。
Beego 默认启用模板渲染，但多数人卡在「数据传不进去」「局部模板不生效」「路径总报错」这三处——核心不是语法不会，而是没理清 c.Data 传递机制、{{template}} 路径解析规则和 beego.SetViewsPath 的作用时机。
模板路径和后缀名必须显式配置才可靠
Beego 默认只认 .tpl 和 .html，且默认模板目录是 views。一旦你把模板挪到 templates 或用了 .gohtml，不配就直接 404。
-
beego.SetViewsPath("templates")必须在beego.Run()之前调用，放错位置等于没设 - 新增后缀要用
beego.AddTemplateExt("gohtml")，注意参数是字符串，不是数组 - 如果同时用多个后缀（比如
.html和.gohtml），要分别调用两次AddTemplateExt - 配置文件里写
viewspath = "templates"也生效，但优先级低于代码中SetViewsPath
数据绑定时 . 和 $ 的作用域容易混淆
模板里写 {{.Title}} 看似简单，但一旦嵌套 range 或 with，. 就会指向子对象，导致 {{.Website}} 找不到——这时候得靠 $ 回到根上下文。
-
{{.Title}}中的.指的是当前作用域，比如range .Articles里，.就是单个 Article 实例 -
{{$.Website}}才能稳定访问 Controller 通过c.Data["Website"]传入的顶层变量 - 结构体字段必须是大写首字母（如
Title string），小写字段（如title string）在模板里不可见 - 如果传的是 map，直接用
{{.User.Name}}；如果是 struct 指针，{{.User.Name}}同样可用，无需解引用
{{template}} 渲染局部模板必须注意路径和上下文
Beego 不提供 partial 封装函数，全靠 Go 原生 {{template "path" .}}。路径错一位、上下文传错类型，就会静默失败或 panic。
- 路径是相对于
views（或你设的SetViewsPath目录）的完整路径，比如views/user/_header.tpl，模板里就得写{{template "user/_header.tpl" .}} - 推荐 partial 文件名以下划线开头（如
_form.tpl），避免被误当主模板路由匹配 - 传
.是传整个c.Data，传.User是只传 User 字段，后者更安全，避免子模板意外读到无关字段 - 跨目录引用（如从
admin/引base/footer.tpl）必须写全路径，不能用../
关闭模板渲染要分清场景：接口服务 vs 混合模式
纯 API 项目关掉 AutoRender 能省开销，但如果你的项目既有 HTML 页面又有 JSON 接口，关了反而麻烦——因为每个需要返回 HTML 的 action 都得手动调 c.Render()，漏一个就 200 空响应。
- 全局关闭：配置文件设
autorender = false，或代码中beego.BConfig.WebConfig.AutoRender = false - 局部开启：关掉全局后，在某个 Controller 方法里仍可调
c.Render()渲染模板，但需确保c.TplName已赋值 - 更稳妥的做法是保留
AutoRender = true，在纯 API 方法里用c.Ctx.WriteString或c.Data["json"] = xxx; c.ServeJSON()绕过模板 - 注意：
c.ServeJSON()会自动设 Content-Type 为application/json，而c.Render()不会干预 HTTP 头
最常被忽略的一点：所有模板路径、{{template}} 引用、c.TplName 赋值，都依赖于 beego.SetViewsPath 是否已执行、是否在 Run() 前完成——这个顺序问题没有错误提示，只有 404 或空白页，查起来特别费时间。
