Revel 项目目录结构是运行时强制契约,路径大小写、嵌套及命名必须严格匹配;revel.AppPath 是唯一可信路径起点,所有资源加载必须基于它拼接,硬编码或 os.Getwd() 均失效。

Revel 项目目录结构不是可选约定,而是运行时强制契约——路径错一个字母、少一个目录、大小写不匹配,都会导致路由 404、模板找不到、配置加载失败。
revel.AppPath 是所有路径的唯一可信起点
框架启动时自动设为包含 conf/、app/、public/ 的根目录,其他路径必须基于它拼接。硬编码 "./conf/app.conf" 或用 os.Getwd() 都会在 revel test、IDE 启动或二进制部署时失效。
-
revel.AppPath + "/conf/app.conf"是配置加载入口,缺失或格式非法会直接 fatal -
revel.AppPath + "/messages"是 i18n 文件唯一识别路径,文件名必须是home.en这类xxx.lang格式,en-US不被识别 -
revel.AppPath + "/public"是静态资源逻辑根路径,但 Revel 不自动 serve,需在 controller 中显式调用StaticFile或配路由
app/ 下三个目录是强制存在且大小写敏感的
Revel 的 MVC 调度器在初始化阶段就扫描这些路径,名字或嵌套结构不对,整个应用就起不来。
-
app/controllers/:必须含AppController.go,所有 controller 结构体需嵌入*revel.Controller;控制器名首字母大写,对应视图目录也必须是app/views/Home/,不能是home/ -
app/views/:模板文件后缀固定为.html,不能用.tmpl或.gotmpl;文件必须放在与控制器同名子目录下,app/views/Home/Index.html才能被HomeController.Index渲染 -
app/models/:虽不被框架自动加载,但 Go 包路径必须合法——即该目录下要有package models声明,且不能被 controller 以外的包(如app/services/)反向 import,否则 build 报循环依赖
tests/ 目录不可重命名、不可移动
Revel 的测试运行器只认项目根目录下名为 tests/ 的目录和其中的 apptest.go。删掉、改名、挪位置,revel test 就完全看不到用例。
-
apptest.go中TestMain必须调用revel.Init("TEST", "tests", "."),参数顺序和字符串字面量不能错 - 控制器测试实例必须由
TestSuite.Controller()构造,不能直接&MyController{}—— 否则依赖注入、filter 链、context 都为空 -
conf/routes中必须显式声明GET /@tests Tests.Index,这是 Web 界面测试入口的路由锚点
最常被忽略的是 revel.AppPath 的不可替代性——它不是“推荐用”,而是“唯一能用”。所有试图绕过它去拼接路径的操作,最终都会在某个环境里崩掉,只是时间问题。











