beego 支持通过 {{template}} 动作复用 html 片段，实现类似 rails partials 的局部模板功能，无需额外配置即可在 views 目录下按路径引用子模板，并支持数据传递。
beego 支持通过 {{template}} 动作复用 html 片段，实现类似 rails partials 的局部模板功能，无需额外配置即可在 views 目录下按路径引用子模板，并支持数据传递。
Beego 原生并未使用 “partials” 这一术语，但其模板引擎完全支持局部模板的嵌入与复用，核心机制正是 Go 标准库 <html/template> 提供的 {{template}} 动作。该能力可有效解耦复杂页面结构，提升模板可维护性与复用率。
✅ 基本用法：嵌入同级局部模板
假设项目视图目录结构如下：
views/ ├── zones/ │ └── new.tpl ← 主模板 └── _form.tpl ← 局部模板（推荐以下划线开头，语义化标识为 partial）
在 new.tpl 中可直接引用：
<h1>New zone</h1>
{{template "_form.tpl" .}}注意：{{template "_form.tpl" .}} 中的 . 表示将当前上下文（如 Controller 传入的 Data）完整传递给 _form.tpl，使其可访问 zone.Name、zone.ID 等字段。
✅ 进阶用法：跨子目录引用 & 显式传参
若将局部模板组织在子目录中（如 views/base/），路径需写全，并建议显式传参以增强可读性与可控性：
<!-- views/zones/new.tpl -->
{{template "base/header.tpl" .}}
<div class="content">
{{template "base/form.tpl" map "zone" .Zone "title" "Create Zone"}}
</div>
{{template "base/footer.tpl" .}}此时 base/form.tpl 可通过 .zone.Name 和 .title 访问传入的数据 —— Beego 会自动将 map 结构转换为模板上下文。
⚠️ 注意事项
- 命名约定：虽非强制，但建议局部模板名以 _ 开头（如 _form.tpl），便于团队识别和 IDE 过滤；
- 路径解析：Beego 默认从 views/ 目录开始解析路径，不支持 ../ 回退；
- 作用域隔离：被嵌入模板无法直接修改父模板变量，所有数据必须显式传递；
- 错误处理：若模板不存在，Beego 在开发模式下会 panic 并显示清晰错误路径，利于快速定位问题。
? 实践建议
参考 Beego 官方开源项目 wetalk 的 views/ 目录，其中大量采用 {{template}} 组织导航栏、分页组件、表单片段等，是学习真实场景下局部模板工程化用法的优质范例。
通过合理规划局部模板结构，你不仅能获得与 Rails partials 高度一致的开发体验，还能充分利用 Go 模板的类型安全与编译时检查优势，构建更健壮、易测试的前端渲染层。
