本文详解如何在Revel框架的Go html/template中正确使用range获取切片索引，并将索引（或当前元素）安全传递给嵌套模板，同时规避nil panic、上下文覆盖与变量命名冲突等常见陷阱。
本文详解如何在revel框架的go `html/template`中正确使用`range`获取切片索引，并将索引（或当前元素）安全传递给嵌套模板，同时规避`nil` panic、上下文覆盖与变量命名冲突等常见陷阱。
在Revel框架中使用模板时，开发者常需遍历数据集合（如[]string、[]*User）并为每个项渲染独立子模板（如{{template "item.html" .}}）。但当需求升级——例如需将当前迭代索引作为参数传入子模板（用于生成唯一ID、序号标记或条件样式）——直接写{{template "item.html" .}}会失败：此时.代表当前元素值，而非索引；而若未显式声明索引变量，模板引擎无法识别$i。
✅ 正确语法：用双变量range显式解构索引与元素
Go模板的range动作支持两种接收模式。对切片/数组，必须使用两个命名变量才能同时捕获索引和值：
{{range $index, $element := .templates}}
{{template "something.html" $index}} // 传入索引（int类型）
{{/* 或 */}}
{{template "something.html" $element}} // 传入当前元素（如string）
{{end}}
? 关键规则：
- 变量名前必须加$（如$index），否则在嵌套作用域中易被覆盖；
- 顺序不可颠倒：第一个是索引（切片）或键（map），第二个是值；
- .在此range块内仍指向当前元素（即$element），但不自动暴露索引——必须通过$index显式引用。
⚠️ 常见陷阱与防御性写法
1. nil切片导致panic → 必须前置判空
直接{{range .templates}}在.templates为nil时会触发运行时panic：
template: xxx: nil pointer evaluating interface {}.templates
✅ 安全写法（推荐）：
{{if .templates}}
{{range $i, $t := .templates}}
<div data-index="{{$i}}">{{template "something.html" $i}}</div>
{{end}}
{{else}}
<div class="empty">暂无模板</div>
{{end}}
? 提示：空切片（len==0）可被range静默跳过，无需额外判断；仅nil需拦截。
2. Revel框架的上下文特殊性：.Title为何为空？
Revel默认不扁平化渲染参数。若控制器中调用：
c.Render(map[string]interface{}{"templates": templates})
则模板中.templates存在，但.Title等字段不会自动注入——因为根上下文是该map，而非其键值。
✅ 正确做法（Revel v0.22+ 推荐）：
c.RenderArgs["templates"] = templates c.RenderArgs["Title"] = "模板列表页" return c.Render()
此时模板中可直接使用{{.Title}}和{{.templates}}。
3. 嵌套range时的变量污染
若在子模板something.html中再次使用range，且未重命名变量，外层$i会被覆盖：
<!-- something.html -->
{{range $j, $item := .items}} <!-- 错误：$j可能覆盖外层$i -->
{{$i}} <!-- 此处$i已失效！ -->
{{end}}
✅ 解决方案：始终为内层变量赋予语义化名称（如$subIndex, $child），或使用with限定作用域。
? 完整工作示例
控制器（app/controllers/app.go）：
func (c App) Index() revel.Result {
templates := []string{"header", "sidebar", "footer"}
c.RenderArgs["templates"] = templates
return c.Render()
}
主模板（app/views/App/Index.html）：
{{if .templates}}
-
{{range $idx, $name := .templates}}
- 第{{$idx}}项： {{template "template-item.html" $idx}} {{end}}
未配置任何模板
{{end}}子模板（app/views/App/template-item.html）：
<span class="template-id">ID-{{.}}</span>
<!-- 输出：ID-0, ID-1, ID-2 -->
✅ 总结要点
- 索引必用双变量range：{{range $i, $v := .Slice}}，$i才是索引；
- 永远防御nil：用{{if .Field}}...{{end}}包裹range；
- Revel中优先用RenderArgs：确保字段在根作用域可用；
- 嵌套时加$前缀+语义名：避免变量意外覆盖；
- 子模板接收参数即{{.}}：传入$i后，在template-item.html中直接{{.}}即可访问该索引值。
遵循以上规范，即可在Revel项目中稳健、清晰地实现带索引的模板复用，兼顾可读性与健壮性。
