在go的`text/template`包中，当使用`range`循环迭代数据时，`.`（点）的上下文会随之改变。本文将介绍两种有效方法来解决此问题：推荐使用`$`变量来始终引用模板执行时的初始数据上下文，以及通过自定义变量在进入`range`循环前捕获父级上下文值。
Go语言的text/template包提供了一套强大的模板引擎，用于生成动态文本内容。然而，在使用range动作遍历切片或映射时，一个常见的挑战是如何在循环内部访问外部（父级或全局）上下文中的数据。这是因为在range循环内部，.（点）的含义会发生变化，它不再指向传递给Execute函数的原始数据结构，而是指向当前迭代的元素。
考虑以下场景，我们有一个包含文件路径前缀和文件列表的结构体，并希望在模板中生成带有完整路径的脚本标签：
package main
import (
"os"
"text/template"
)
// scriptFiles 结构体包含一个路径前缀和文件列表
type scriptFiles struct {
Path string
Files []string
}
func main() {
// 定义一个模板，尝试在range循环中访问.Path
// 这里的 .Path 预期是 scriptFiles 结构体的 Path 字段
// 但在 range .Files 内部，. 变成了 Files 列表中的每个元素
const page = `{{range .Files}}{{end}}`
t := template.New("page")
t = template.Must(t.Parse(page))
// 执行模板，传入 scriptFiles 实例
data := &scriptFiles{"/var/www", []string{"go.js", "lang.js"}}
t.Execute(os.Stdout, data)
}运行上述代码，会发现{{html .Path}}在range .Files内部无法正确访问到scriptFiles结构体的Path字段。这是因为在range .Files内部，.的上下文已经变更为Files切片中的每个字符串元素（例如"go.js"），而字符串类型并没有Path字段。
为了解决这个问题，Go模板提供了两种主要方法来在range循环内部访问父级或全局上下文。
方法一：使用 $ 全局上下文变量 (推荐)
Go模板引擎提供了一个特殊的变量$，它始终指向传递给Execute函数的初始数据参数。无论当前dot（.）的上下文如何变化，$变量始终保持不变，指向模板执行的根数据。
因此，我们可以通过$.Path来访问原始scriptFiles结构体中的Path字段。
package main
import (
"os"
"text/template"
)
type scriptFiles struct {
Path string
Files []string
}
func main() {
// 修改模板，使用 $.Path 来访问全局上下文的 Path 字段
const page = `{{range .Files}}{{end}}`
t := template.New("page")
t = template.Must(t.Parse(page))
data := &scriptFiles{"/var/www", []string{"go.js", "lang.js"}}
t.Execute(os.Stdout, data)
}输出结果：
这种方法简洁明了，是访问全局或根数据上下文的首选方式，因为它明确表达了你正在引用模板执行的起始数据。
方法二：使用自定义变量传递上下文
另一种方法是在进入range循环之前，将父级上下文中的所需值赋值给一个自定义变量。这样，这个自定义变量就会在range循环的作用域内可用。
package main
import (
"os"
"text/template"
)
type scriptFiles struct {
Path string
Files []string
}
func main() {
// 修改模板，在进入 range 循环前将 .Path 赋值给 $p 变量
const page = `{{$p := .Path}}{{range .Files}}{{end}}`
t := template.New("page")
t = template.Must(t.Parse(page))
data := &scriptFiles{"/var/www", []string{"go.js", "lang.js"}}
t.Execute(os.Stdout, data)
}输出结果：
在这个例子中，{{$p := .Path}}在range循环开始之前执行，将当前上下文（即scriptFiles实例）的Path字段值赋给变量$p。随后，在range循环内部，$p变量就可以被访问，而不会受到.上下文变化的影响。
这种方法在某些情况下可能显得更灵活，例如当你需要对父级上下文的某个字段进行预处理，或者需要传递多个父级上下文中的值时。然而，对于直接访问根数据，$变量通常是更直接和推荐的选择。
注意事项与总结
- 理解上下文 (.)： 在Go模板中，.（点）代表当前的数据上下文。它的值会根据模板动作（如range、with）而动态变化。
- $ 的作用： $变量提供了一个稳定的锚点，它始终指向模板Execute函数接收的原始数据。这使得它成为在任何嵌套层级访问全局或根数据的理想选择。
- 自定义变量的作用域： 使用{{$var := .Field}}创建的变量，其作用域从定义点开始，直到当前代码块（例如range、if、with）结束。
- 安全性： 在输出任何用户提供或动态生成的内容到HTML时，务必使用{{html .}}或{{html $var}}等函数进行转义，以防止跨站脚本攻击（XSS）。
- 选择方法： 对于直接访问模板的根数据，$变量是更简洁和惯用的选择。如果需要访问更深层父级而非根级的数据，或者需要对父级数据进行预处理，自定义变量可能更具表现力。
掌握这两种方法，将使您在Go模板中处理复杂数据结构和上下文切换时更加得心应手，编写出更健壮、更灵活的模板。
