Go/Revel 模板中安全遍历切片并传递索引与元素的完整实践指南-Golang-PHP中文网

Go/Revel 模板中安全遍历切片并传递索引与元素的完整实践指南

本文详解如何在 Revel 框架的 Go html/template 中正确使用 range 遍历切片，同时获取当前索引（如 $i）和元素值，并安全传入子模板；重点澄清 . 的上下文含义、避免 nil panic 及嵌套变量覆盖陷阱。

本文详解如何在 revel 框架的 go `html/template` 中正确使用 `range` 遍历切片，同时获取当前索引（如 `$i`）和元素值，并安全传入子模板；重点澄清 `.` 的上下文含义、避免 nil panic 及嵌套变量覆盖陷阱。

在 Go Web 开发中，Revel 框架基于标准库 html/template 构建其模板系统，语法简洁但语义严谨。开发者常需在主模板中遍历数据集合（如 []string 或 []*User），并将当前项或索引传递给复用的子模板（如 "something"）。然而，直接写作 {{template "something" .}} 仅传递当前迭代元素，若需索引则必须显式声明——这正是问题的核心。

✅ 正确写法：用双变量 range 显式绑定索引与元素

range 动作支持两种接收模式：单变量（仅元素）和双变量（索引/键 + 元素/值）。对于切片或数组，必须使用 $index, $element := .Collection 形式才能获取索引：

{{range $i, $t := .templates}}
    {{template "something.html" $i}}  // 传入索引 0, 1, 2...
{{end}}

? 注意：变量名前加 $ 是强制要求——它声明该变量作用域为当前 range 块内，避免与外层同名变量（如控制器传入的 .Index）冲突。不加 $（如 i, t）虽语法允许，但一旦模板中存在字段 .i，就会引发静默覆盖，导致逻辑错误。

假设控制器中设置：

func (c App) Index() revel.Result {
    c.RenderArgs["templates"] = []string{"Header", "Sidebar", "Footer"}
    return c.RenderTemplate("Index.html")
}

子模板 something.html 内容为：

<div class="template-{{.}}">{{.}}</div>

渲染结果将为：

使用Go语言搭建家庭相册系统-相关课件

下载

<div class="template-0">0</div>
<div class="template-1">1</div>
<div class="template-2">2</div>

若想同时传入索引和元素，可构造匿名结构体或 map：

{{range $i, $t := .templates}}
    {{template "something.html" (dict "Index" $i "Value" $t)}}
{{end}}

（需在 Revel 中注册 dict 函数，或改用 map[string]interface{} 传参）

⚠️ 关键陷阱与避坑指南

{{.}} 不是“nil”，而是当前作用域的根对象
在 {{range .templates}}...{{end}} 中，{{.}} 指代的是当前迭代的 元素值（如 "Header"），而非整个数据源。所谓“. means nil”实为误解——真正导致 panic 的是 .templates 本身为 nil。例如：
```
{{range .templates}} ... {{end}}  // 若 .templates == nil → panic!
```
✅ 安全写法必须前置判空：
```
{{if .templates}}
    {{range $i, $t := .templates}}
        <div data-index="{{$i}}">{{$t}}</div>
    {{end}}
{{else}}
    <div>暂无模板</div>
{{end}}
```
Revel 的模板上下文是扁平化的 RenderArgs
Revel 默认将 c.RenderArgs 合并到模板根作用域（即 .），因此 {{.templates}} 能直接访问。但若使用 c.Render(map[string]interface{}{...})，旧版 Revel 会将整个 map 作为 .，新版推荐统一使用 RenderArgs 以保证一致性。

嵌套 range 时务必显式命名，防止 . 覆盖
如需渲染用户列表及其权限：

{{range $u := .Users}}
    <h3>{{$u.Name}}</h3>
    {{range $p := $u.Permissions}}  <!-- ❌ 错误：$p 是权限项，但 . 仍指向 $u -->
        <span>{{$.Name}}: {{$p}}</span>  <!-- ✅ 用 $. 访问外层用户 -->
    {{end}}
{{end}}

更清晰的做法是全程使用 $ 前缀变量：

{{range $user := .Users}}
    <h3>{{$user.Name}}</h3>
    {{range $perm := $user.Permissions}}
        <span>{{$user.Name}}: {{$perm}}</span>
    {{end}}
{{end}}