Revel模板继承不依赖{{block}},而是通过{{set . "key" "value"}}在子模板首行设置变量,并由布局模板(如main.html)显式引用{{.key}};{{set}}必须位于模板最开头,且布局需在控制器中显式指定或手动渲染填充{{.body}}。

Revel模板继承不是靠{{block}},而是靠{{set}} + 布局模板显式调用
Revel的模板系统不走Go标准库html/template那一套define/template组合,也不支持{{block}}语法。它用的是自己封装的渲染逻辑:子模板通过{{set . "key" "value"}}向布局模板传递变量,布局模板再用{{.key}}或{{with .key}}消费——整个过程没有“父模板自动包裹子模板”的隐式行为。
常见错误现象:app/views/app/index.html里写了{{set . "title" "首页"}},但页面标题没变,或者main.html里{{.title}}输出为空。原因通常是:{{set}}语句没放在模板最开头(必须在任何{{if}}、{{range}}或HTML标签之前),或者布局模板压根没被当前路由指定为渲染目标。
-
{{set}}必须是模板文件的第一条语句,否则Revel会忽略它 - 布局模板(如
app/views/layout/main.html)需要在控制器中显式指定:c.RenderArgs["layout"] = "layout/main",或全局配置app.Init()时设置默认layout - 子模板不会自动“继承”布局;你得让控制器返回的模板名指向布局,再把子内容作为
.body传进去,或者靠{{template}}手动嵌入(这时才用到标准html/template机制)
如何让子模板内容填进main.html的{{.body}}位置
Revel默认的main.html布局里一般有{{.body}}占位符,但它不会自动捕获子模板的HTML输出。要让它生效,你得在控制器里把子模板渲染结果作为字符串塞进去,而不是直接c.Render("index")。
典型做法是:先用revel.BE.Template单独渲染子模板得到string,再把它赋给.body,最后Render("main")。这步绕开了Revel默认的模板流转逻辑,属于“手动接管”。
- 不要依赖
c.Render("index")自动套layout——Revel不会帮你做这个包装 - 如果坚持用
{{template "content" .}}方式,则必须确保main.html和index.html都被template.ParseFiles一次性加载进同一个*template.Template实例,否则报template: "content" is undefined - 路径注意:Revel的
views/下文件名即模板名,app/views/user/list.html对应模板名"user/list",不是"list"
静态资源路径错乱?public/目录是唯一出口
Revel只从public/目录提供静态文件服务,CSS/JS引用路径必须以/开头且映射到public/子目录。写成./css/app.css或css/app.css会404。
比如你在app/views/layout/main.html里加:,实际文件必须放在public/css/app.css。如果放错位置,浏览器控制台会明确报GET /css/app.css 404。
- 所有静态资源(CSS、JS、图片、字体)必须放在
public/下,不能放在app/、conf/或views/里 - SCSS编译后必须输出到
public/css/,Grunt或Makefile脚本里路径别写错 - CDN链接可以直写,但本地资源路径出错是Revel新手最常卡住的点,建议第一次就用
curl -I http://localhost:9000/css/app.css验证是否可访问
多个子页面共用一个layout时,title和meta怎么动态变
每个子模板都用{{set . "title" "xxx"}}没问题,但要注意:这些set操作只影响当前模板作用域,不会污染其他请求。Revel每次HTTP请求都会新建一个RenderArgs map,所以app/views/home.html设了title,不会影响app/views/user/list.html的title值。
真正容易出问题的是meta标签拼接。比如你想在main.html里写:,但某个子模板忘了{{set . "title"}},结果变成| MyApp空标题。这时候不能靠{{with}}兜底,因为{{.title}}是空字符串而非nil,{{with}}仍会进入分支。
- 推荐在
main.html里用{{if .title}}{{.title}} | {{else}}默认标题 | {{end}}MyApp显式判断 - 如果大量页面都需要统一前缀,可以把前缀写死在
main.html里,子模板只负责{{set . "title" "首页"}},避免重复逻辑 - 不要试图在
app/init.go里全局set,Revel的set只对当前模板生效,跨模板无效
Revel模板继承的复杂点不在语法,而在职责划分:它把“数据传递”和“结构组装”拆成了两件事。你得自己决定是用{{set}}传简单变量,还是用template.ParseFiles加载整套模板树——选错路径,轻则标题不显示,重则整个页面白屏且无报错提示。











