Revel模板找不到主因是未被扫描或缓存残留:必须存于app/views/子目录下、后缀为.html、路径大小写严格匹配;需清空app/tmp/并重启,再通过真实请求触发编译校验。

Revel 模板找不到,八成不是路径写错了,而是模板没被编译进缓存、或根本没被框架扫描到——它不报 template not found,而是直接 panic 或返回 500,因为 Revel 在启动时就预编译所有模板,失败就拒启。
确认模板是否被 Revel 扫描到
Revel 只加载 app/views/ 下的 .html 文件,且必须在子目录中(如 app/views/User/show.html),根目录下的 app/views/index.html 不会被识别。检查点包括:
- 文件后缀必须是
.html,.tpl、.htm一律忽略 - 路径必须以
app/views/开头,不能是views/或templates/ - 文件名不能含大写字母或特殊符号(如
User-List.html),Revel 会跳过 - 确保
app/views/目录存在且非空——Revel 不报“目录不存在”,而是静默跳过整个目录
dev 模式下看不到模板错误?先清 tmp
Revel 把编译后的模板转成 Go 代码,存进 app/tmp/templates/。一旦这里残留旧文件,哪怕你改了 show.html,Revel 仍执行旧字节码,导致“改了没反应”或“报错行号对不上”。必须手动清理:
- 停掉
revel run进程 - 删掉整个
app/tmp/目录(不是只删templates/) - 重启
revel run myapp,确认终端输出Running in dev mode - 再访问对应路由,此时若出错,错误页顶部会显示
views/User/show.html:23这类真实位置
模板名和控制器调用必须严格匹配
Revel 的 c.Render() 或 c.RenderTemplate() 传入的模板名,是相对于 app/views/ 的路径,不含扩展名,且区分大小写:
- 控制器里写
c.Render("User/show")→ 对应app/views/User/show.html - 写
c.Render("user/show")→ 找不到,因为目录名User是大写 - 写
c.Render("User/show.html")→ 找不到,Revel 不认扩展名 - 写
c.Render("show")→ 只有当show.html在app/views/根目录下才有效(但通常不推荐放根目录)
嵌套模板路径写错会导致静默失败
用 {{template "header.html" .}} 时,Revel 默认从 app/views/ 开始找,不支持相对路径。比如在 app/views/Admin/dashboard.html 里写 {{template "../header.html" .}},Revel 会尝试加载 app/views/../header.html,即 app/header.html,而这不是合法路径,结果就是空白页或 panic。
- 所有
{{template}}引用必须是app/views/下的完整路径,如{{template "header.html" .}}或{{template "Admin/sidebar.html" .}} - 如果
header.html放在app/views/layout/,就得写{{template "layout/header.html" .}} - 没有
include指令,只有template;别指望{{include "xxx"}}能工作
最常被忽略的是:Revel 启动时不做模板存在性校验,它只在第一次请求该模板时才编译。所以你改完配置、删完 tmp、跑起来没报错,不代表模板就对了——得真去浏览器点开那个路由,才能触发真正校验。


















