Revel新手踩坑主因是约定未守死：路由空格、大小写、路径、包名、参数名必须严格匹配，否则静默失败；模板嵌套需用{{template}}且作用域明确；数据库路径须用revel.AppPath而非os.Getwd()。
Revel 新手踩坑，八成出在「约定没守死」——不是框架太难，而是它对大小写、路径、包名、参数名的匹配极其严格，且不报错，只静默失败。
conf/routes 里一个空格就让路由失效
Revel 的路由解析器不跳过前导空格，也不做 trim，GET /login App.Login 和 GET /login App.Login（开头多个空格）是两条完全不同的规则，后者直接被忽略。
- HTTP 方法、路径、控制器方法之间**必须用单个空格分隔**，不能用 Tab 或多个空格
- 控制器名和方法名大小写必须与 Go 源码中**完全一致**：
App.Login✅，app.login❌ - 第一行必须是注释，比如
# This file defines all application routes，否则旧版本 Revel 会跳过整个文件 - 路径中用了
:id，控制器方法参数名必须是小写id，写成ID或Id都绑定失败
控制器文件放错位置或包名不对，请求永远进不来
Revel 只扫描 app/controllers/ 目录下的文件，且只认包名为 app 的结构体方法。放错一格、改错一个字母，App.Login 就永远调用不到。
- 正确路径：
app/controllers/app.go，开头为package app - 错误路径：
controllers/app.go（缺app/前缀）、app/handlers/app.go（目录名非controllers） - 错误包名：
package main、package controllers、package（空包名）→ 方法不会被反射识别 - 结构体方法签名第一个参数必须是
*App或对应控制器指针，返回revel.Result，漏掉*或写成App（值接收）也会静默跳过
模板渲染空白或 layout 不生效，其实是嵌套方式错了
Revel 没有 Blade 那种 @extends 继承机制，所有「布局嵌套」本质是 {{template}} 包含，多层嵌套会 panic，作用域也容易丢失。
- 不要写
{{template "admin/layout" .}}再让它去调{{template "base/layout" .}}→ 渲染时报template "base/layout" not defined - 所有页面模板（如
app/views/users/index.html）只定义{{define "body"}}，不主动调其他 layout - 主布局（如
app/views/layouts/main.html）里用{{template "body" .}}注入内容，用{{template "header" .}}复用区块 - partial 模板必须以
{{define "header"}}开头，调用时必须带.：{{template "header" .}}，省略会丢上下文
model.go 里读写数据库路径总出错，别信 os.Getwd()
os.Getwd() 在 revel test、IDE 启动、二进制部署下常返回空或错误路径；runtime.Caller 回溯到 Revel 内部栈帧，根本找不到你的 model.go。
- 唯一可靠的是 Revel 内置的
revel.AppPath，它始终指向项目根目录（含conf/、app/、public/的目录） - 构建数据库路径时，用
filepath.Join(revel.AppPath, "data", "app.db")，而不是拼接os.Getwd()或os.Args[0] - 如果要用相对路径加载 SQL 文件或配置，也统一基于
revel.AppPath构造，避免开发/测试/生产环境行为不一致
最麻烦的不是语法写错，而是错得没有提示——404 不告诉你路由没配对，参数为空不报绑定失败，模板空白也不说 partial 名字冲突。守死约定、逐字符核对、用好 revel.AppPath，比查文档更管用。
