Revel 本身不内置类似 RenderLayout() 的布局机制，但可通过 Go 原生模板的 {{template}} 指令组合根布局模板与子模板，实现灵活、可复用的页面结构。本文详解两种主流实践方式，并提供可直接运行的代码示例与关键注意事项。
revel 本身不内置类似 `renderlayout()` 的布局机制，但可通过 go 原生模板的 `{{template}}` 指令组合根布局模板与子模板，实现灵活、可复用的页面结构。本文详解两种主流实践方式，并提供可直接运行的代码示例与关键注意事项。
在 Revel 中实现模板布局，核心在于利用 Go 标准库 html/template 的嵌套模板能力（{{define}} / {{template}}），而非依赖框架原生的 Layout API（Revel 1.x 及当前主流版本均未提供 c.RenderLayout() 方法）。以下为两种经生产验证的推荐方案：
✅ 方案一：显式复用根布局模板（推荐）
此方式语义清晰、易于维护，适用于大多数项目。
-
定义根布局模板（views/layouts/root.html）：
<!DOCTYPE html> <html> <head> <title>{{.Title | default "My App"}}</title> </head> <body> <header> <nav>导航栏内容</nav> </header> <main> {{template "content" .}} <!-- 定义可替换的内容区块 --> </main> <footer>© 2024 MyApp</footer> </body> </html> -
创建子模板（如 views/app/index.html），仅定义 content 模板块：
{{define "content"}} <h1>首页</h1> <p>欢迎使用 Revel！当前时间：{{.Now.Format "2006-01-02 15:04"}}</p> {{end}} -
控制器中渲染时指定布局模板（app/controllers/app.go）：
package controllers
import ( "github.com/revel/revel" )
type App struct { *revel.Controller }
func (c App) Index() revel.Result { c.RenderArgs["Now"] = time.Now() c.RenderArgs["Title"] = "首页 - MyApp" // 渲染 root.html，并自动注入已定义的 "content" 模板 return c.RenderTemplate("layouts/root.html") }
> ⚠️ 注意：`c.RenderTemplate("layouts/root.html")` 是关键——它直接加载布局模板，而子模板（`index.html`）通过 `{{define "content"}}` 提前注册到全局模板集合中，Revel 会自动合并所有 `.html` 文件中的 `{{define}}` 块。
### ✅ 方案二：在子模板内主动调用布局（兼容性更强）
适用于需动态选择布局或旧项目迁移场景。
- `views/app/dashboard.html`（子模板）：
```html
{{template "layouts/root.html" .}}- views/layouts/root.html（同上，含 {{template "content" .}}）
- views/app/dashboard.html 需额外定义 content：
{{define "content"}} <h2>仪表盘</h2> <div class="stats">...</div> {{end}}
此时控制器仍调用 c.Render()，Revel 会自动加载 dashboard.html；该文件再通过 {{template}} 指令拉取并渲染 root.html，形成嵌套。
? 关键注意事项
- 模板路径区分大小写：Revel 按文件系统路径匹配模板，确保 layouts/root.html 路径拼写准确；
- {{define}} 必须在顶层作用域：不可嵌套在 {{if}} 或 {{range}} 内，否则无法被外部引用；
- 避免循环引用：切勿让 root.html 再次 {{template "root.html"}}，将导致 panic；
- 性能提示：Revel 在启动时编译所有模板，因此布局复用不会带来运行时开销；
- 替代方案：若需更高级布局（如多级嵌套、动态 layout 切换），建议封装自定义 RenderLayout() 方法到 BaseController。
通过以上任一方式，你即可在 Revel 中构建出结构统一、维护高效、符合现代 Web 工程实践的模板体系。
