Revel模板修改后无刷新,首要确认热重载是否启用:终端必须显示“INFO Watching for changes”,否则需检查是否误用revel build、IDE终端截断日志、run.mode非dev或文件未落在app/views/*/.html等监控路径内。

Revel 的模板修改后自动刷新依赖热重载机制,但默认只在 revel run 启动且文件落在监控路径内时才生效;改了 app/views/ 下的 .html 文件却没反应,大概率是热重载根本没触发,而不是浏览器缓存问题。
确认热重载是否真在运行
终端启动时必须看到 INFO Watching for changes 这行日志,否则热重载压根没开。常见原因有:
- 误用
revel build+ 手动执行二进制,这种模式下热重载完全不存在 - 在 VS Code 集成终端中运行
revel run,部分 shell 配置会截断日志输出,建议换系统原生终端重试 -
conf/app.conf中run.mode = prod,热重载强制禁用,必须设为dev
检查模板文件是否在监听路径内
Revel 默认只监听以下位置的变更:
-
app/views/**/*.html(含所有子目录) conf/routes-
conf/app.conf(部分配置项,如results.json.indent)
如果你把模板放在 app/views/shared/ 或自定义路径如 templates/ 下,Revel 不会感知——它不扫描整个项目,只认白名单路径。解决方法是:要么移回 app/views/ 下,要么在 conf/app.conf 中显式添加:watch.paths = app/views/shared
禁用模板缓存并清空编译产物
即使热重载触发了,Revel 仍可能用旧的编译后 Go 代码渲染模板,导致“改了却没变”。关键操作有两步:
- 在
conf/app.conf中设置:template.caching = false,避免模板字节码被复用 - 每次怀疑缓存残留时,手动删掉项目根目录下的
tmp/文件夹,再重启revel run—— 这个步骤不能省,revel clean命令有时漏删部分缓存
注意:浏览器硬刷(Ctrl+Shift+R)只能清 HTTP 缓存,对 Revel 模板编译缓存无效。
为什么改了模板、终端显示“reloading”,但页面还是旧的?
这通常不是热重载失效,而是模板编译阶段出错被静默吞掉了。Revel 在 dev 模式下本应报错并展示带行号的错误页,但若你没清过 tmp/,旧缓存会覆盖新错误映射,导致页面空白或返回上一个成功渲染的结果。最稳妥的做法是:每次模板修改后,先删 tmp/,再保存文件,最后刷新——尤其当你刚引入新 {{include}} 或拼错 {{.User.Name}} 时,这个顺序能暴露真实问题。


















