Revel 本身不内置类似 RenderLayout() 的布局机制，但可通过 Go 原生模板的 {{template}} 指令组合根布局模板与子模板，实现灵活、可复用的页面结构。本文详解两种主流实践方式，并提供可直接运行的代码示例与关键注意事项。

revel 本身不内置类似 `renderlayout()` 的布局机制，但可通过 go 原生模板的 `{{template}}` 指令组合根布局模板与子模板，实现灵活、可复用的页面结构。本文详解两种主流实践方式，并提供可直接运行的代码示例与关键注意事项。

在 Revel 中实现模板布局，核心在于利用 Go 标准库 html/template 的嵌套模板能力（{{define}} / {{template}}），而非依赖框架原生的 Layout API（Revel 1.x 及当前主流版本均未提供 c.RenderLayout() 方法）。以下为两种经生产验证的推荐方案：

✅ 方案一：显式复用根布局模板（推荐）

此方式语义清晰、易于维护，适用于大多数项目。

1. 定义根布局模板（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>

2. 创建子模板（如 views/app/index.html），仅定义 content 模板块：

   

   Revel框架 0.19.0

   Revel框架 0.19.0 版本源码包下载，适合关注 Referrer-Policy、vendor 识别、Gorp 事务抽象和 CSRF 修复的开发团队。

   下载

   {{define "content"}}
   <h1>首页</h1>
   <p>欢迎使用 Revel！当前时间：{{.Now.Format "2006-01-02 15:04"}}</p>
   {{end}}

3. 控制器中渲染时指定布局模板（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 工程实践的模板体系。