在 go 的 text/template 包中，range 动作是遍历切片、数组、映射或通道的强大工具。然而，当进入 range 循环时，模板的当前上下文（即 . 变量）会发生变化，它会指向循环中的每个元素。这导致一个常见的问题：如何在 range 循环内部访问 range 动作执行前的父级或全局管道数据？
考虑以下场景，我们有一个 scriptFiles 结构体，包含一个 Path 字段和 Files 切片。我们希望在遍历 Files 时，使用 Path 作为脚本的基础路径。
package main
import (
"os"
"text/template"
)
// .Path won't be accessible, because dot will be changed to the Files element
const page = `{{range .Files}}{{end}}`
type scriptFiles struct {
Path string
Files []string
}
func main() {
t := template.New("page")
t = template.Must(t.Parse(page))
t.Execute(os.Stdout, &scriptFiles{"/var/www", []string{"go.js", "lang.js"}})
}在上述代码中，{{range .Files}} 循环内部，{{html .Path}} 将无法正确访问到 scriptFiles 结构体的 Path 字段。这是因为 . 在循环内部已经变成了 Files 切片中的字符串元素（例如 "go.js"），而字符串类型没有 Path 字段，从而导致模板渲染错误或输出空值。
使用 $ 变量 (推荐)
Go 模板提供了一个特殊的全局变量 $，它始终指向 template.Execute 方法接收的原始数据参数，即模板执行时的初始上下文。这意味着 $ 变量在整个模板的生命周期内都保持不变，即使 . 变量在 range 或 with 等动作中发生改变。
要解决上述问题，我们可以在 range 循环内部使用 $.Path 来访问根数据中的 Path 字段：
const page = `{{range .Files}}{{end}}`通过将 page 常量更新为上述内容并运行 main 函数，输出将变为：
这种方法简洁明了，是访问根上下文数据的推荐方式。
定义自定义变量
另一种方法是在进入 range 循环之前，将父级或全局管道中的所需值赋值给一个自定义变量。这个自定义变量在定义后，其值在当前作用域（包括其子作用域，如 range 循环内部）是可访问的。
我们可以通过 {{$variableName := .FieldName}} 的语法来定义一个变量。例如，在 range .Files 之前捕获 .Path：
const page = `{{$p := .Path}}{{range .Files}}{{end}}`在这个示例中：
- {{$p := .Path}} 在 range 循环开始前执行，此时 . 仍然是 scriptFiles 结构体。它将 scriptFiles.Path 的值赋给变量 $p。
- 进入 {{range .Files}} 循环后，尽管 . 变为切片元素，但 $p 变量的值保持不变，并且在循环内部依然可以访问。
- 因此，{{html $p}} 能够正确地输出 /var/www。
这种方法在某些情况下也很有用，例如当你需要对父级数据进行一些预处理，或者需要访问的不是根上下文而是 range 外层某个特定作用域的数据时。
总结
在 Go 模板的 range 循环中访问外部上下文数据是常见的需求。通过理解 . 变量的作用域变化，我们可以选择两种主要策略来解决：
- 使用 $ 变量： 这是访问 template.Execute 传入的原始根数据的最直接和推荐方式。$ 始终指向模板的全局上下文。
- 定义自定义变量： 在 range 循环前将所需数据赋值给一个局部变量，该变量在 range 循环内部依然有效。这种方式提供了更大的灵活性，尤其是在需要访问非根层级的数据时。
在大多数需要访问模板根数据（Execute 的参数）的场景中，$ 变量是更简洁、更易读的选择。
