Revel模板遍历切片必须用{{range}}而非{{for}}或{{foreach}},需注意切片非nil、字段首字母大写、作用域切换及括号匹配。

模板里用 {{range}} 遍历切片,不是 {{for}} 或 {{foreach}}
Revel 模板语法基于 Go 的 text/template,不支持类 JavaScript 的 for 循环写法。常见错误是写成 {{for i, v := range .Items}} 或直接套用其他框架的 {{foreach}},这会导致编译失败,报错类似:template: xxx: unexpected "for" in command。
正确做法是用 {{range}} 动作配合点(.)作用域切换:
-
{{range .Users}}进入循环后,.指向当前元素(比如一个User结构体),可直接写{{.Name}}、{{.ID}} - 需要索引或键?用
{{range $i, $u := .Users}},然后用{{$i}}和{{$u.Name}} - 空切片时默认不渲染任何内容,如需 fallback,加
{{else}}分支:{{range .Items}}{{.Value}}{{else}}暂无数据{{end}}
.Users 传入模板前必须是已初始化的切片,nil 会 panic
Revel 控制器中若写 c.Render("index.html", revel.M{"Users": users}),而 users 是 nil(比如数据库查无结果未做初始化),模板执行 {{range .Users}} 时会 panic,错误信息类似:panic: reflect.Value.Interface: cannot return value obtained from unexported field or method(实际更可能是 invalid memory address,因 nil 切片无法 range)。
安全做法始终初始化切片:
- 声明时:
var users []User(非var users []User = nil) - 查询后:
if users == nil { users = []User{} } - 或用 Revel 的
c.RenderArgs预设默认值,但不如代码层显式初始化可靠
结构体字段必须首字母大写,否则模板里取不到
Go 模板只能访问导出(public)字段。如果 User 定义为:
type User struct {
name string // 小写 → 模板里 {{.name}} 为空
ID int // 大写 → {{.ID}} 可读
}
那么 {{range .Users}}{{.name}} {{.ID}}{{end}} 中 {{.name}} 始终输出空字符串,且无报错——这是最容易被忽略的静默失败。
检查方式很简单:在控制器里 revel.INFO.Printf("%+v", users[0]) 看日志是否打印出该字段;模板里临时加 {{printf "%#v" .}} 可确认当前作用域的完整值。
嵌套遍历和条件组合要小心作用域和括号匹配
多层 {{range}} 嵌套时,每层都会改变 . 含义,容易误用外层变量。例如:
{{range .Groups}}
Group: {{.Name}}
{{range .Users}} <!-- 此时 . 是 User,不是 Group -->
{{.Name}} (belongs to {{.GroupName}}?) <!-- 错!.GroupName 不存在 -->
{{end}}
{{end}}
解决方法是提前用变量捕获外层值:
{{range $g := .Groups}}...{{range $g.Users}}...{{$g.Name}}...- 或更清晰地命名:
{{range $group := .Groups}}{{$group.Name}}{{range $user := $group.Users}}{{$user.Name}}{{end}}{{end}} - 所有
{{必须有对应{{end}},少一个会导致模板编译失败,错误提示常指向末尾而非缺失处——建议编辑器开启模板括号高亮
复杂逻辑别硬塞进模板,优先在控制器里预处理成扁平结构。











