revel 框架不支持 blade 式模板继承，其 html/template 仅支持单层布局+显式 partial 包含；需用 {{define}}/{{template}} 手动组合，避免多层嵌套导致 panic 或作用域混乱。
Revel 框架不支持 Blade 那种 @extends 嵌套继承
Revel 的模板系统基于 Go 的 html/template，它本身没有「模板继承」概念，也没有 @yield 或 @section 这类语法。所谓“布局嵌套”，实际是靠 {{template "name" .}} 和 {{define "name"}} 手动组合实现的——本质是模板包含（include），不是继承。
常见错误现象：
- 误以为可以写
{{template "admin/layout" .}}再在子模板里写{{template "base/layout" .}}实现链式嵌套 → 渲染时直接 panic: template "base/layout" not defined - 把多个
{{template}}嵌在同一个{{define}}块里，导致变量作用域混乱、.传参丢失
正确做法是单层主布局 + 显式内容注入：
- 只定义一个顶层布局模板，比如
app/views/layouts/main.html - 所有页面模板（如
app/views/users/index.html）不调用其他布局，只{{define "body"}}块 - 主布局中用
{{template "body" .}}注入内容，用{{template "header" .}}、{{template "footer" .}}复用区块
如何复用 header / sidebar / flash 提示等公共区块
Revel 推荐将可复用 UI 抽成独立模板文件，放在 app/views/partials/ 下（路径可自定，但需统一）。
使用场景：
-
app/views/partials/header.html：含导航、用户头像、登出链接，依赖.CurrentUserName -
app/views/partials/flash.html：渲染Flash.Out["success"]或Flash.Out["error"] -
app/views/partials/form_errors.html：接收.Errors并循环输出
关键点：
- 每个 partial 模板必须以
{{define "partial_name"}}开头，名称要唯一（避免冲突） - 调用时必须显式传参：
{{template "flash" .}}，不能省略.，否则 partial 内无法访问上下文数据 - 不要在 partial 里再嵌套
{{template}}调用其他 partial —— 容易形成隐式依赖链，调试困难
为什么不能用多层 template 包含模拟“继承”
Go 的 html/template 在解析阶段就确定了模板依赖关系。当你写：
{{define "admin/base"}}{{template "header" .}}{{template "content" .}}{{end}}
{{define "users/index"}}{{template "admin/base" .}}{{end}}
这不会生效，因为 "admin/base" 不是一个已加载的模板名；Revel 只自动加载 app/views/ 下一级目录中的模板（如 users/index.html），不会递归扫描子目录或拼接路径。
性能与兼容性影响：
- 手动拼接模板名（如
{{template (printf "%s/base" .Layout) .}}）会破坏编译期检查，运行时报错才暴露 - 模板缓存失效：每次修改任意 partial，整个主布局的 compiled template 都需重建
- IDE 无法跳转、无语法提示，重构成本高
真正简洁的复用结构：layout + partial + controller 数据预处理
Revel 的优势在于「约定优于配置」，但这个约定不包括模板嵌套深度。整洁的关键是把逻辑从视图里移出去。
实操建议：
- Controller 中统一设置
c.RenderArgs["CurrentUser"] = user、c.RenderArgs["NavItems"] = getNavItems()，避免在多个 partial 里重复查数据库 - 用
RenderArgs传递结构化数据，而不是裸传*revel.Controller，防止 partial 意外调用c.RenderError()等副作用方法 - 对需要条件渲染的区块（如管理员专属菜单），在 controller 判断后传布尔值：
c.RenderArgs["ShowAdminMenu"] = isAdmin，模板里只写{{if .ShowAdminMenu}}{{template "admin/menu" .}}{{end}} - 避免在模板里写
{{if eq .User.Role "admin"}}...{{end}}—— 权限逻辑属于 controller 层，视图只负责呈现
最容易被忽略的是：Revel 的 RenderArgs 是 map[string]interface{}，类型擦除严重。传复杂结构体时，务必在 controller 里做字段裁剪，别把整个 model 丢进模板 —— 否则一旦 model 字段变更，模板可能静默失败或渲染空值。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
