执行revel new命令可生成开发态项目骨架，但需确认三件事：revel cli已安装并加入path、go版本≥1.17、项目目录无残留tmp/run目录；启动时应显式指定-addr 127.0.0.1 -p 9000，并确保app.conf中app.mode = dev生效。
revel new 命令能直接生成可运行的项目骨架，但默认配置和路径容易导致启动失败或访问不到页面——关键在于理解它生成的是「开发态」结构，不是开箱即用的生产服务。
执行 revel new 后必须确认的三件事
很多新手跑完 revel new -a myapp 就立刻浏览器访问 http://localhost:9000，结果看到连接被拒绝。这不是命令失败，而是没满足以下任一前提：
-
revelCLI 已正确安装且在$PATH中（验证：运行revel version能输出版本号） - Go 环境已就绪（Revel 1.1.0 要求 Go ≥ 1.17；运行
go version检查） - 项目目录下没有残留的
tmp或run目录（旧版 Revel 会卡住编译缓存，删掉再试）
revel run 启动时端口与地址必须显式指定
默认 revel run -a myapp 会监听 0.0.0.0:9000，但某些系统（尤其是 macOS Monterey+ 或启用了防火墙的 Linux）会拦截该绑定。更稳妥的做法是：
- 强制绑定到本地回环：
revel run -a myapp -addr 127.0.0.1 -p 9000 - 若提示
address already in use，换端口（如-p 9001），不要依赖自动探测 - 首次启动时控制台输出最后一行应为
Running on :9000（不是Starting...就停住）
模板渲染失败常见于 .Render() 调用方式错误
控制器里写 return c.Render("Hello") 不会自动匹配 app/views/App/Index.html，Revel 的路由-控制器-模板映射是严格按命名约定来的：
- 函数名
Index()→ 模板路径必须是app/views/App/Index.html -
c.Render(message)把message绑定到模板中的.message（不是.Message或.MessageValue） - 若模板里写
{{.message}}却报nil pointer dereference，说明c.Render()传参类型不匹配（比如传了string但模板当struct用）
热重载失效往往因为文件系统通知未就绪
修改 app/controllers/app.go 后页面没刷新，不是框架坏了，而是 fsnotify 库监听失败：
- Linux 用户需确认
/proc/sys/fs/inotify/max_user_watches≥ 524288（小值会导致监听丢事件） - macOS 用户若用 Dropbox 或 iCloud 同步项目目录，禁用同步或把项目移到非同步路径
- Windows 上 WSL2 默认不支持 inotify，建议在原生 Windows 终端中运行，或改用
revel build && ./myapp手动重启
app/conf/app.conf 里的 app.mode = dev 是否生效——如果误设为 prod，热重载和错误详情页都会静默关闭。
