本文探讨了在 go `text/template` 包的 `range` 循环中，如何有效访问外部或全局作用域变量的问题。当 `.` 管道值在循环内部发生变化时，直接访问父级数据会变得困难。教程将详细介绍两种解决方案：使用预定义的 `$` 变量以及通过自定义变量捕获外部作用域值，并提供示例代码，帮助开发者在 go 模板中灵活处理数据上下文。
在 Go 语言的 text/template 包中，range 循环是处理列表或数组数据时常用的结构。然而，一个常见的挑战是在 range 循环内部，当前上下文（即 . 管道值）会切换到集合中的每个元素。这导致无法直接访问循环外部或更高级别的父级作用域变量，例如在 Execute 方法中传入的原始数据结构。
考虑以下场景：我们需要为一系列脚本文件生成 HTML <script> 标签，其中脚本的路径包含一个基础路径，而这个基础路径是作为整个数据结构的一部分提供的。
package main
import (
"os"
"text/template"
)
// 期望访问 .Path，但 . 会在 range 循环中变为 Files 切片中的元素
const page = `{{range .Files}}<script src="{{html .Path}}/js/{{html .}}"></script>{{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 循环内部访问 scriptFiles 结构体的 Path 字段。然而，当 . 变为 Files 切片中的单个字符串元素时，{{.Path}} 将无法解析，因为字符串类型没有 Path 字段。为了解决这个问题，Go 模板提供了两种有效的方法来访问外部作用域变量。
使用 $ 变量访问全局管道 (推荐)
Go 模板提供了一个特殊的全局变量 $（美元符号），它始终指向 Execute 方法调用时传入的原始数据参数。这意味着无论当前 . 管道值如何变化，$ 变量始终保持对初始数据上下文的引用。因此，在 range 循环内部，我们可以通过 $.Path 来访问原始数据结构中的 Path 字段。
这种方法简洁明了，是访问全局或父级作用域变量的首选方式，尤其是在层级不深的情况下。
const page = `{{range .Files}}<script src="{{html $.Path}}/js/{{html .}}"></script>{{end}}`将上述模板应用于 scriptFiles 结构体，输出将是：
<script src="/var/www/js/go.js"></script> <script src="/var/www/js/lang.js"></script>
可以看到，$.Path 成功地引用了原始 scriptFiles 结构体的 Path 字段。
使用自定义变量捕获外部作用域值
另一种方法是在进入 range 循环之前，将外部作用域中需要访问的变量赋值给一个自定义变量。这个自定义变量在当前模板作用域内有效，并且其值在 range 循环内部不会随 . 的变化而改变。
语法如下：{{$variable := .Value}}。
const page = `{{$p := .Path}}{{range .Files}}<script src="{{html $p}}/js/{{html .}}"></script>{{end}}`在这个例子中，{{$p := .Path}} 将 scriptFiles 结构体的 Path 字段值赋给了变量 $p。随后在 range .Files 循环内部，我们可以安全地使用 $p 来访问这个路径，而不会受到 . 管道值变化的影响。
这种方法在某些场景下也很有用，例如当你需要对外部变量进行一些预处理，或者需要引用一个并非直接来自 Execute 参数的父级变量时。然而，对于直接访问 Execute 参数的顶级字段，$ 变量通常更为直接和推荐。
总结与注意事项
在 Go 模板的 range 循环中访问外部作用域变量是常见的需求。本文介绍了两种主要策略：
- 使用 $ 变量： 这是访问 Execute 方法传入的原始数据参数的推荐方式。$ 始终指向模板执行的初始上下文，无论 . 管道值如何变化。它简洁高效，适用于大多数需要访问全局或顶级数据的场景。
- 使用自定义变量： 通过 {{$var := .Value}} 语法在进入 range 循环前捕获外部作用域值。这种方法提供了更大的灵活性，可以在需要对外部值进行预处理或引用非顶级父级变量时使用。
选择哪种方法取决于具体的上下文和个人偏好。但在可能的情况下，优先使用 $ 变量，因为它清晰地表达了对全局上下文的引用。理解 . 和 $ 的区别是编写健壮 Go 模板的关键。
