Beego模板目录可通过beego.SetViewsPath("templates")在main.go中设置，或在conf/app.conf中配置viewspath="templates"；默认支持.tpl和.html后缀，非标后缀需调用beego.AddTemplateExt("ext")注册。
模板目录路径怎么设
Beego 默认从 views 目录加载模板，但这个路径不是写死的，而是可配置的。如果项目结构里用了 templates 或 myviews，必须显式改掉默认值，否则会 404 找不到模板。
两种方式任选其一：
- 在
main.go中调用beego.SetViewPath("templates")（推荐，代码可控） - 在配置文件
conf/app.conf中写viewspath = "templates"
注意：路径是相对于项目根目录的，不要加前导 /；若设为 "./templates" 反而可能出错——Beego 内部用的是绝对路径解析逻辑，只认相对根目录的纯路径名。
模板后缀不识别怎么办
Beego 默认只认 .tpl 和 .html，遇到 .gohtml、.tmpl 或自定义后缀（比如 .vue.html）时，c.TplName = "index.gohtml" 会静默失败，日志里也不报错，只返回空响应或 500。
必须提前注册扩展名：
- 在
main.go初始化阶段调用beego.AddTemplateExt("gohtml") - 可多次调用，支持多个后缀：
beego.AddTemplateExt("tmpl"); beego.AddTemplateExt("vue.html")
没加这句就直接用非标准后缀，模板根本不会被 Beego 的模板缓存系统扫描到，后续所有渲染都无效。
自动渲染模式下模板名怎么生成
如果你没手动设置 c.TplName，Beego 会在自动渲染（autorender = true，默认开启）时按规则拼模板路径：strings.ToLower(c.controllerName) + "/" + strings.ToLower(c.actionName) + "." + c.TplExt。
例如 IndexController.Get() 会去找 views/index/get.html（假设 TplExt = "html"）。
常见陷阱：
- 控制器名含大写字母（如
UserAPIController），拼出的路径变成userapicontroller/xxx.html，但实际目录是userapi/——大小写不一致导致 404 -
TplExt没统一设，默认是"tpl"，但你模板文件是.html，结果找index/get.tpl而不是index/get.html
解决办法：要么显式赋值 c.TplName，要么确保目录结构和命名严格匹配小写规则 + 后缀一致。
Layout 布局和 LayoutSections 怎么联动
Beego 的 Layout 不是简单 include，而是靠 {{template "header" .}} 这类子模板引用实现的，所以必须配合 c.LayoutSections 显式注册片段路径。
关键点：
-
c.Layout = "layout.html"必须是真实存在的文件，且该文件里要包含{{template "Header" .}}、{{template "Footer" .}}等命名占位符 -
c.LayoutSections["Header"] = "common/header.html"中的键名（"Header"）必须和 layout 文件里的template名完全一致（大小写敏感） - 所有被引用的子模板（如
common/header.html）也必须在views/下存在，且后缀已通过AddTemplateExt注册过
漏掉任意一个环节，页面要么空白，要么报 template: "Header" is undefined 错误——这个错误不会打在 HTTP 响应里，只出现在控制台日志，容易被忽略。
