Revel模板修改不生效主因是tmp目录缓存未清,需执行revel clean彻底删除app/tmp/,再revel run重启;同时在[dev]下设template.caching=false禁用缓存,并确认热重载监听到app/views/*/.html路径。

Revel 模板改了不生效,八成是缓存没清干净——不是浏览器缓存,也不是你代码写错了,而是 Revel 自己在 tmp/ 目录下偷偷编译并缓存了 Go 版模板字节码,且默认启用模板缓存机制。
为什么改了 HTML 却看不到效果
Revel 把 .html 模板编译成 Go 代码(如 template_user_show_html.go)后存进 app/tmp/templates/,后续请求直接执行这个缓存版本。哪怕你删了原始文件、改了内容、甚至重启了 revel run,只要 tmp/ 还在,旧编译结果就还在用。
- 修改模板后刷新页面仍显示旧内容,或报错行号指向已删除的代码
- 终端没输出
【INFO】 Watching for changes,说明热重载根本没启动 - 改了
conf/app.conf但template.caching配置没生效,因为配置加载早于缓存初始化
必须执行 revel clean 清空 tmp 目录
revel clean 是唯一能彻底清除模板编译产物的命令,它会删掉整个 app/tmp/ 目录,包括 templates/、routes/、views/ 等所有中间产物。光删 tmp/templates 子目录不够,残留的路由缓存或视图注册可能干扰重建。
- 运行
revel clean后再执行revel run yourapp,确保终端出现Watching for changes - 不要手动
rm -rf app/tmp—— 某些系统权限或 IDE 锁定可能导致部分文件删不净 - 如果项目用了 Docker,确认挂载卷没把
tmp/映射成只读,否则revel clean会静默失败
禁用模板缓存强制每次重编译
开发阶段建议关掉模板缓存,避免反复清理。只需在 conf/app.conf 的 [dev] 区块中添加:
template.caching = false
该配置让 Revel 每次请求都重新解析并编译模板,跳过 tmp/templates/ 缓存路径。注意:
- 必须放在
[dev]下,[prod]下设了也无效 - 改完配置要重启
revel run,热重载不监听app.conf的此项变更 - 性能影响极小——本地开发时单次编译耗时通常低于 5ms
检查热重载是否真在监控你的模板路径
Revel 默认只监听 app/views/**/*.html,但如果你把模板放在 app/views/shared/ 或 app/views/layouts/ 这类子目录下,得确认路径匹配规则是否覆盖到。更隐蔽的问题是:
- 某些编辑器(如 VS Code)保存时先写临时文件再原子替换,触发的是
.swp或~文件事件,Revel 不响应这类变更 - 使用 WSL2 或 Docker Desktop 时,inotify 事件可能被文件系统层截断,可临时在
app/views/下新增一个测试文件验证监听是否活跃 - 若你把模板放到了
public/或自定义目录(如resources/templates/),Revel 根本不会监控——它只认app/views/
最稳妥的做法:改模板 → revel clean → revel run → 刷新;三步做完还无效,就打开 app/tmp/templates/ 看对应 .go 文件的修改时间是否更新——那是真相所在。











