本文详解如何在Revel框架的HTML模板中正确使用range遍历切片、获取当前索引，并将索引（或元素）作为参数传递给嵌套子模板，同时规避nil panic、上下文丢失和变量覆盖等常见陷阱。
本文详解如何在revel框架的html模板中正确使用`range`遍历切片、获取当前索引，并将索引（或元素）作为参数传递给嵌套子模板，同时规避nil panic、上下文丢失和变量覆盖等常见陷阱。
在Go语言Web开发中，Revel框架基于标准库html/template构建其模板系统，语法简洁但隐含若干关键约定——尤其当涉及循环迭代与子模板传参时，稍有不慎便会导致渲染失败、空指针panic或数据不可见等问题。本文聚焦一个高频场景：在{{range}}中获取当前索引 $i，并将其作为参数传递给{{template}}调用，并给出可落地的完整方案。
✅ 正确语法：显式声明索引与元素变量
range动作支持双变量接收模式，语法为：
{{range $index, $element := .Collection}}
{{template "sub.html" $index}} // 传索引
{{template "sub.html" $element}} // 传元素值
{{end}}
其中：
- $index 是整数类型（切片/数组）或键名（map）；
- $element 是对应位置的值；
- 必须以$开头命名，否则在嵌套作用域中易被覆盖（如内层.Name会遮蔽外层同名变量）。
例如，在Revel控制器中传递切片：
func (c App) Index() revel.Result {
c.RenderArgs["templates"] = []string{"header", "sidebar", "footer"}
return c.Render()
}
对应模板 app/views/App/Index.html：
{{range $i, $t := .templates}}
<div class="section-{{$i}}">
{{template "partial/section.html" $i}}
</div>
{{end}}
子模板 app/views/partial/section.html 内容：
<h3>Section #{{.}}</h3> <!-- . 即传入的 $i -->
输出结果为：
<div class="section-0"> <h3>Section #0</h3> </div> <div class="section-1"> <h3>Section #1</h3> </div> <div class="section-2"> <h3>Section #2</h3> </div>
⚠️ 关键注意事项
-
永远防御 nil 切片
{{range .templates}} 遇到 nil 会直接 panic：nil pointer evaluating interface {}.templates。务必前置判空：{{if .templates}} {{range $i, $t := .templates}} {{template "partial/section.html" $i}} {{end}} {{else}} <p class="empty">暂无模板项</p> {{end}} Revel 的模板上下文不是“扁平”的
Revel 默认将 RenderArgs 合并至根作用域（即 .），但若使用 c.Render(map[string]interface{...})，则整个 map 成为 . —— 此时需写 {{range $i, $t := .templates}}；而若仅传切片 c.Render(templates)，则 . 就是该切片本身，此时应写 {{range $i, $t := .}}。推荐统一使用 c.RenderArgs 显式赋值，语义清晰且兼容性高。-
避免变量名污染（尤其嵌套模板）
若子模板 section.html 内还需遍历（如权限列表），请勿复用 $i：<!-- section.html --> <h3>Section #{{.}}</h3> {{with $.Permissions}} <!-- 使用 $. 访问根上下文的 Permissions --> {{range $pidx, $perm := .}} <span class="perm-{{$pidx}}">{{ $perm }}</span> {{end}} {{end}}这里 $.Permissions 明确指向根上下文的字段，避免与当前 .（即索引值）冲突。
结构体字段必须导出（首字母大写）
若切片元素是结构体（如 []User），User.Name 在模板中才可访问；user.name 将静默为空。
? 总结
在Revel中安全使用带索引的模板迭代，核心在于三点：
? 显式命名：始终用 $i, $v := range 而非单变量；
? 防御性编程：range 前加 {{if}} 检查非 nil；
? 上下文意识：理解 ., $, $. 的作用域差异，优先通过 RenderArgs 统一管理数据入口。
遵循上述实践，即可在Revel项目中稳定、可维护地实现动态模板组合与索引驱动渲染。
