Revel 模板渲染核心是 c.Render() 传入导出字段命名结构体、map 或基础类型；range 遍历切片必须用 {{$i, $v := .Items}} 获取索引和元素；子模板参数类型由 template 调用时传入值决定，无隐式上下文回溯。
Revel 框架渲染模板并传递数据，核心就一条：用 c.Render() 把 Go 值传进模板作用域，但字段必须导出、切片要显式解构、. 的含义随时在变——不注意这三点，90% 的模板空白或 nil panic 都由此而来。
控制器里调用 c.Render() 时传什么类型最安全
只能传命名结构体（非匿名）、map 或基础类型；不能传未导出字段的 struct 实例。Revel 底层用 Go 标准 html/template，它靠反射读取字段，而 Go 反射只认首字母大写的导出字段。
- ✅ 正确示例：
type User struct { Name string; Age int }→c.Render(user)中{{.Name}}可访问 - ❌ 错误示例：
type user struct { name string }→{{.name}}渲染为空，且无报错，极难排查 - ⚠️ 注意：即使传的是
map[string]interface{}，其中的 value 若是未导出 struct，嵌套访问仍会失败（如map["data"]=&privateStruct{}→{{.data.field}}不生效）
range 遍历切片时怎么同时拿到索引和元素
Go 模板的 range 对切片/数组只支持双变量解构，且顺序固定：第一个是索引（$i），第二个是值（$v）。单变量写法（如 {{range .Items}}）会让 . 指向当前元素，但彻底丢失索引。
- ✅ 必须写成：
{{range $i, $v := .Items}}，然后可用{{$i}}和{{$v.Name}} - ⚠️ 变量名前必须加
$：不写$i而写i，模板会当成字面量字符串，不是变量 - ⚠️ 切勿颠倒顺序：
{{range $v, $i := .Items}}会导致$v是 int 索引、$i是元素值，语义全乱 - ? 小技巧：若只需索引，仍得写双变量，空占位用
$_（如{{range $i, $_ := .Items}}）
子模板接收参数时为什么总是 nil 或类型错乱
子模板接收的参数类型完全取决于你 {{template}} 调用时传进去的那个值，和主模板的 . 无关。常见错误是误以为 . 在子模板里还代表原始上下文。
立即学习“前端免费学习笔记（深入）”；
- ✅ 正确传索引：
{{template "item.html" $i}}→ 子模板中.就是int类型索引 - ✅ 正确传结构体：
{{template "item.html" $v}}→ 子模板中.就是那个User实例 - ❌ 错误写法：
{{template "item.html" .}}在range块内 →.是当前元素，不是原始控制器传来的整个数据对象 - ⚠️ 如果子模板需要多个值，必须打包成 map 或结构体再传，模板不支持多参数语法
最易被忽略的一点：Revel 的 c.Render() 默认把所有传入参数挂到模板根作用域，但一旦你在 range 或 with 里改变了 .，再想回退到上层数据，只能靠显式传参或预存变量（如 {{$root := .}}），没有 .. 这种父级引用语法。
