Revel模板路径必须严格匹配app/views/Controller/Action.html,仅识别该约定结构;控制器名首字母大写、方法名精确对应文件名,大小写错误或目录缺失直接导致404。

模板路径必须严格匹配 app/views/Controller/Action.html
Revel 不会查找任意路径的 HTML 文件,只认 app/views/ 下的固定结构。控制器名首字母大写(如 App),对应目录 app/views/App/;Action 方法名(如 Index)对应文件 Index.html。调用 c.RenderTemplate("App/Show.html") 时,它实际找的是 app/views/App/Show.html,不是相对当前模板位置。常见错误是大小写不一致或少了一级目录,报错里明确写着 template "App/Index.html" not found,基本就是这个原因。
Render 和 RenderTemplate 传参方式完全不同
二者都触发渲染,但数据注入逻辑不同,混用容易覆盖变量:
-
c.Render(username, email)→ 模板中直接用.userName、.email(自动转小驼峰,UserName变成.userName) -
c.RenderArgs["user"] = user; c.RenderTemplate("User/Show.html")→ 模板中必须用.user.Name,.user是你手动塞进RenderArgs的 key - 如果同时调用
c.Render(u)又设c.RenderArgs["u"] = u,后者会覆盖前者——因为Render内部也是往RenderArgs写 - 在模板里写
.User.Name会 panic,正确是.user.Name(小写开头)
range 遍历切片必须先判空,索引要显式解构
{{range .Items}} 中的 . 是当前元素,索引不会自动存在。想把索引传给子模板,必须用双变量语法:
- 错误写法:
{{range .Items}}{{template "item.html" .}}{{end}}→ 子模板收不到索引 - 正确写法:
{{range $i, $item := .Items}}{{template "item.html" (dict "Index" $i "Item" $item)}}{{end}}(注意$i前的$不能省) - 若没注册
dict函数(Revel 默认未注册),改用(map "index" $i "value" $item),前提是已在app/init.go中注册了revel.TemplateFuncs["map"] - nil 切片会导致 panic,务必加外层
{{if .Items}}包裹;空切片(len==0)可被range静默跳过,无需额外判断
嵌入子模板必须用 {{render}},路径不含 .html 后缀
Revel 不支持标准 Go 模板的 {{template "name" .}},统一用 {{render}}:
- 写法:
{{render "App/Footer.html"}}→ 自动查找app/views/App/Footer.html,并传入当前上下文 - 路径必须带目录前缀,
{{render "Footer.html"}}会报错no such template;{{render "/App/Footer.html"}}开头斜杠会被忽略或报错 - 子模板作用域独立,不继承父模板中
{{with}}或{{range}}定义的局部变量;需显式传参,例如{{render "User/Avatar.html" .CurrentUser}} - 子模板里不能直接访问父模板的
.Title或.Page,除非你把它作为参数传进去
最容易被忽略的是:所有路径大小写敏感、dict 函数默认未注册、Render 和 RenderArgs 混用导致变量覆盖——这三个点一旦出错,页面要么 404,要么空数据,且错误信息不直接指向根源。











