本文旨在解决在使用 Go 模板时，如何在 with 或 range 语句创建的内部作用域中访问外部作用域的问题。通过使用 $ 符号，可以轻松访问模板执行的根数据对象，从而访问外部作用域中的变量和字段。本文将通过示例代码详细说明 $ 的用法。
在使用 Go 的 text/template 或 html/template 包时，with 和 range 语句会创建新的作用域。这意味着在这些语句内部，. (点) 会指向当前作用域的数据对象，而不是外部作用域。 因此，直接访问外部作用域的变量会变得困难。 幸运的是，Go 模板提供了一个特殊的变量 $，它始终指向模板执行的根数据对象。
$ 的作用
$ 变量在模板执行开始时被设置为传递给 Execute 方法的数据参数，也就是根数据对象。 无论当前处于哪个作用域，$ 始终指向这个根数据对象，因此可以通过 $ 访问外部作用域的变量。
示例
假设我们有以下 Go 结构体：
type Outer struct {
OuterValue string
Inner Inner
}
type Inner struct {
InnerValue string
}我们想要在模板中使用 with 语句访问 Inner 结构体，并在其中同时访问 Outer 结构体的 OuterValue 和 Inner 结构体的 InnerValue。 可以使用以下模板：
{{with .Inner}}
Outer: {{$.OuterValue}}
Inner: {{.InnerValue}}
{{end}}在这个模板中：
- .Inner 将当前作用域设置为 Inner 结构体。
- .InnerValue 访问 Inner 结构体的 InnerValue 字段。
- $.OuterValue 使用 $ 访问根数据对象（Outer 结构体），然后访问其 OuterValue 字段。
完整的 Go 代码示例
package main
import (
"fmt"
"os"
"text/template"
)
type Outer struct {
OuterValue string
Inner Inner
}
type Inner struct {
InnerValue string
}
func main() {
outer := Outer{
OuterValue: "This is the outer value",
Inner: Inner{
InnerValue: "This is the inner value",
},
}
tmpl, err := template.New("test").Parse(`
{{with .Inner}}
Outer: {{$.OuterValue}}
Inner: {{.InnerValue}}
{{end}}
`)
if err != nil {
panic(err)
}
err = tmpl.Execute(os.Stdout, outer)
if err != nil {
panic(err)
}
}这段代码的输出将是：
Outer: This is the outer value Inner: This is the inner value
注意事项
- $ 始终指向根数据对象，即使在嵌套的 with 或 range 语句中也是如此。
- 使用 $ 可以方便地访问外部作用域的变量，但过度使用可能会降低模板的可读性。 在可能的情况下，尽量避免在深层嵌套的作用域中频繁访问外部作用域的变量。
- 理解 . 和 $ 的区别是掌握 Go 模板的关键。 . 代表当前作用域，而 $ 代表根作用域。
总结
通过使用 $ 变量，可以轻松地在 Go 模板的 with 或 range 语句中访问外部作用域的变量。 这使得在模板中处理复杂的数据结构变得更加容易。 记住，$ 始终指向根数据对象，因此可以通过它访问任何外部作用域的字段。
