Revel热编译默认开启但依赖严格路径对齐：项目须置于$GOPATH/src/下，app.importPath须与go list路径完全一致，否则静默失效；模板修改不生效常因大小写、扩展名或缓存所致。
Revel 的热编译默认开启且几乎零配置，失效时基本不是框架本身问题，而是项目结构、路径或 GOPATH 环境没对齐。
revel run 启动失败并报 Failed to import with error: import "": invalid import path
这是最典型的热编译“静默失效”现象：你改了代码、保存、刷新页面，但什么都没变；终端也没报错，甚至看起来服务还在跑——其实 Revel 根本没加载你的应用逻辑。
- 根本原因是
revel run无法解析app.importPath，而该值来自conf/app.conf，它必须与 Go 的包导入路径严格一致 - 项目必须放在
$GOPATH/src/下，例如$GOPATH/src/github.com/yourname/myapp；若放在桌面或任意目录（如C:/myapp），revel run就会因找不到包路径而 fallback 到空字符串 -
app.conf中的app.importPath必须写成完整导入路径，比如github.com/yourname/myapp，不能是myapp或相对路径 - 执行
revel run前，先运行go list github.com/yourname/myapp，能成功返回才说明路径和 GOPATH 都正确
代码修改后浏览器无变化，但终端显示 “Compiling…” 却没 reload 日志
这说明 Revel 检测到了文件变更、触发了编译，但新字节码没被加载进运行时——本质是 Go 的 build cache 或 .revel 目录残留导致的“假编译”。
- 删掉项目根目录下的
.revel文件夹（它缓存了上次编译产物和路由映射） - 运行
go clean -cache -modcache清理 Go 构建缓存，尤其当你升级过 Go 版本或切换过模块模式时 - 确认你修改的是
app/controllers/或app/views/下的文件；Revel 默认只监听这些目录，src/或lib/下的改动不会触发热编译 - 检查文件保存编码是否为 UTF-8 无 BOM；Windows 记事本另存时常带 BOM，会导致 Revel 解析模板失败却静默跳过
模板修改不生效，但 controller 返回值已更新
说明热编译在 Go 层生效了，但 HTML 模板没被重新解析——常见于路径拼写错误或模板缓存未失效。
- Revel 模板路径区分大小写：
App/Index.html和app/index.html是两个不同路径；Controller 中调用c.Render()时传的视图名必须与磁盘路径完全一致 - 确保模板文件扩展名是
.html（不是.htm或.tpl），且位于app/views/子目录下（如app/views/App/Index.html） - Revel 不会自动 reload 已编译的模板字节码；可临时在
conf/app.conf中添加template.reload = true强制每次请求都重读文件（仅开发用） - 浏览器端可能缓存了旧 HTML；按
Ctrl+F5硬刷新，或禁用 DevTools 的 “Disable cache” 选项再试
修改 conf/app.conf 后重启服务才生效，想热更新配置怎么办？
Revel 默认只在启动时读一次 app.conf，改配置不重启确实不会生效——这不是 bug，是设计使然。但你可以用拦截器+定时重载绕过。
- 不要依赖
revel.Config.String()在 Controller 里硬取值；改用c.Request.Context注入动态值 - 写一个每 5 秒读一次
app.conf的 goroutine，在app/init.go的init()函数中启动，把结果存到全局变量或 sync.Map - 更稳妥的做法是：把需要热更新的配置项（如开关、超时时间）单独拆到
conf/dev.conf，并在拦截器中用os.ReadFile手动读取，避免走 Revel 的静态配置缓存 - 注意：数据库连接串、端口号等底层配置仍需重启，热更新只适用于业务级开关类参数
真正卡住 Revel 热编译的，从来不是语法或框架逻辑，而是 $GOPATH 路径、app.importPath 字符串、文件系统大小写敏感性这些“看不见”的约束。调试时优先验证路径是否被 go list 识别，比反复检查代码逻辑更省时间。
