Revel 模板默认从 app/views/ 及其子目录和 revel/templates/ 两个目录加载,优先查找前者,未命中时回退到后者。

Revel 模板默认从哪两个目录加载?
Revel 会按固定顺序搜索模板:先查 app/views/ 及其所有子目录,再 fallback 到 Revel 自带的 revel/templates/。这意味着你可以在 app/views/errors/500.html 中覆盖框架默认的 500 错误页,而无需修改任何源码。
常见错误是把模板放在 app/templates/ 或 views/(缺 app 前缀)——Revel 完全不会扫描这些路径,直接报 template: not found。
- 开发时模板改动自动热重载,但仅限
app/views/下的文件 -
revel/templates/里的模板(如errors/404.html)只在你没提供同名模板时生效 - 路径区分大小写,
App/views/和app/views/是不同目录
怎么在模板里安全传入索引并渲染子模板?
用 range 遍历切片时,必须显式声明两个变量:$index 和 $item,否则无法拿到索引。直接写 {{range .Items}}{{template "item.html" .}} 会把当前元素传进去,不是索引。
更关键的是,.Items 为 nil 时模板会 panic,必须提前判断:
{{if .Items}}
{{range $i, $item := .Items}}
<div data-id="{{$i}}">{{template "item.html" $i}}</div>
{{end}}
{{else}}
<p class="empty">暂无数据</p>
{{end}}
- 变量名前加
$(如$i)是必须的,不加会被当作字面量字符串 - 顺序不能颠倒:
$i是索引(int),$item是值;对 map 则是$key, $value - 空切片(
len==0)可被range安静跳过,只有nil需拦截
layout 模板里 {{yield}} 和 {{include}} 有什么区别?
{{yield}} 是 layout 的“内容占位符”,由子模板决定往哪塞;{{include "sub.tpl"}} 是 layout 主动拉取并立即执行子模板——两者语义完全相反,混用会导致内容重复或丢失。
典型错误是:在 app/views/layout.html 里写了 {{include "header.html"}},又在 app/views/home.html 顶部也写 {{include "header.html"}},结果 header 渲染两次。
-
{{yield}}只能出现在 layout 模板中,且只能出现一次(多处 yield 行为未定义) -
{{include}}可嵌套、可传参,但参数作用域仅限该 include 调用内部 - Revel 不支持
{{block}}语法,别试图模仿其他模板引擎的 block 机制
为什么 .Title 在模板里为空?
因为 Revel 不自动扁平化控制器传入的数据。如果你在控制器里写 c.Render(map[string]interface{}{"Items": items}),那模板里的根上下文就是这个 map,.Title 就不存在——它不是 map 的 key。
解决办法只有两种:要么把所有字段都塞进 map({"Title": "首页", "Items": items}),要么改用结构体传参:
type HomeData struct {
Title string
Items []string
}
c.Render(HomeData{Title: "首页", Items: items})
- map 方式灵活但易漏字段;结构体方式类型安全,推荐用于稳定接口
-
.Title这类字段不会从 Revel 的全局上下文自动注入,必须显式传入 - 模板里访问
.Title前,先确认它是否在当前作用域内(可用{{printf "%#v" .}}调试)
Revel 模板最易被忽略的点是上下文隔离性:每个 Render() 调用都生成全新上下文,父模板和子模板之间没有隐式继承关系,所有数据必须显式传递。











