本文详解如何在Revel框架的Go html/template中正确使用range获取切片索引（如$i）和当前项（如$t），并将其作为参数传入嵌套模板，同时规避nil panic、上下文丢失及变量覆盖等常见陷阱。
本文详解如何在revel框架的go `html/template`中正确使用`range`获取切片索引（如`$i`）和当前项（如`$t`），并将其作为参数传入嵌套模板，同时规避`nil` panic、上下文丢失及变量覆盖等常见陷阱。
在Go语言Web开发中，html/template是构建动态HTML页面的核心工具；而Revel框架在此基础上封装了约定式模板加载与上下文注入机制。开发者常需在主模板（如header.html）中遍历数据集合（如.templates），并将当前迭代索引或元素作为参数传递给复用的子模板（如"something"）。但若直接写作{{template "something" .}}，其中.在range内部仅表示当前元素值，无法直接获取索引——此时必须显式声明索引变量。
✅ 正确语法：双变量接收 + 显式传参
range动作支持两种变量绑定形式，关键在于是否需要索引：
-
仅需元素值（默认行为）：
{{range .templates}} {{template "item.html" .}} // . = 当前字符串（如 "One"） {{end}} -
需要索引与元素（推荐用于带序号场景）：
{{range $i, $t := .templates}} {{template "item.html" $i}} // 传入索引：0, 1, 2... {{/* 或 */}} {{template "item.html" $t}} // 传入元素值："One", "Two" {{/* 或组合传入结构体（见下文） */}} {{end}}
? 变量命名规范：$i、$t 等以 $ 开头的标识符是模板局部变量，可避免嵌套作用域中与结构体字段（如.ID）同名冲突。不加 $（如i, t）虽语法允许，但一旦模板内存在同名字段（如User.i），将导致不可预期覆盖。
⚠️ 常见陷阱与规避方案
1. nil 切片导致 panic —— 必须前置判空
{{if .templates}}
{{range $i, $t := .templates}}
<div data-index="{{$i}}">{{template "item.html" $t}}</div>
{{end}}
{{else}}
<div class="empty">暂无模板项</div>
{{end}}
❗ 错误写法：{{range .templates}}...{{end}} 在 .templates 为 nil 时会触发运行时 panic：nil pointer evaluating interface {}.templates。range 本身不处理 nil，必须由外层 {{if}} 或 {{with}} 拦截。
2. Revel 框架的上下文特殊性
Revel 默认将控制器传入的数据（如 c.Render("templates", templates)）直接设为模板根上下文 .，而非包裹在 map[string]interface{} 中。因此：
- {{.}} 在 range 外表示整个传入对象（如 []string）；
- {{.}} 在 range 内（未声明变量时）自动切换为当前迭代项；
- 若需在子模板中同时访问索引和元素，建议传入匿名结构体：
{{range $i, $t := .templates}} {{template "item.html" struct "Index" $i "Value" $t}} {{end}}子模板中即可用 {{.Index}} 和 {{.Value}} 安全访问。
3. 嵌套 range 的变量污染
多层循环时，内层 . 会覆盖外层作用域。例如渲染用户及其权限列表：
{{range $u := .Users}}
<h3>User: {{$u.Name}}</h3>
{{range $p := $u.Permissions}} <!-- 必须用 $u 显式引用外层变量 -->
<span>Perm: {{$p.Code}}</span>
{{end}}
{{end}}
若误写为 {{range .Permissions}}，则 . 已指向当前用户 $u，而非根上下文，易引发字段访问失败。
? 实战示例：Revel 控制器 + 模板协同
控制器（app/controllers/app.go）
func (c App) Header() revel.Result {
templates := []string{"dashboard", "profile", "settings"}
return c.Render(templates) // 直接传切片，Revel 将其设为 .
}
主模板 app/views/App/Header.html
{{if .}}
<nav>
{{range $i, $name := .}}
<a href="/page/%7B%7B%24name%7D%7D" data-order="{{$i}}">
{{template "nav-item.html" $name}}
</a>
{{end}}
</nav>
{{else}}
<nav class="disabled">No templates loaded</nav>
{{end}}
子模板 app/views/App/nav-item.html
<span class="nav-label">{{. | title}}</span> <!-- . 即传入的 $name 字符串 -->
? 提示：Revel 自动对 {{.}} 输出做 HTML 转义，防止 XSS；如需原始 HTML，使用 {{. | safeHTML}}（需确保内容可信）。
✅ 总结要点
- 使用 {{range $i, $v := .Slice}} 显式获取索引与值，变量名前加 $ 是最佳实践；
- 永远对可能为 nil 的切片加 {{if .Field}} 保护，这是 Go 模板健壮性的基石；
- Revel 中 . 的含义取决于作用域层级：顶层为控制器传入数据，range 内为当前项，子模板中为传入参数；
- 避免隐式依赖框架行为（如自动扁平化 RenderArgs），优先使用显式变量传递提升可维护性。
掌握这些模式后，你不仅能安全渲染带序号的列表，还能构建高度复用的模块化模板系统——这正是 Revel “约定大于配置”理念下，专业级 Go Web 开发的正确打开方式。
