在go语言的`text/template`或`html/template`中，当您迭代一个切片或映射时，当前上下文（`.`）会切换到循环中的每个元素。若需在循环内部访问模板接收的原始、顶层数据结构的字段，可以使用特殊变量`$`。`$`始终指向模板执行时传入的根数据对象，从而允许您在循环中结合局部数据与全局上下文来生成内容。

在Go语言的Web开发或内容生成场景中，我们经常需要将一个复杂的数据结构传递给模板进行渲染。这个数据结构可能包含多个字段，其中一些是简单的字符串或数字，另一些则是切片或嵌套的结构体。当我们需要遍历切片中的元素，同时又希望引用该切片所属的父级数据结构中的其他字段时，就会遇到上下文切换的问题。

模板中的上下文与挑战

考虑以下Go结构体：

type Site struct {
    Name  string
    Pages []int
}

我们希望将Site的一个实例传递给模板，然后遍历Pages切片，为每个页面生成一个链接。一个常见的需求是，这个链接的路径不仅包含页码，还包含网站的名称（即Site.Name）。

如果仅仅是遍历Pages，模板代码可能如下所示：

{{range .Pages}}
    
Page {{.}}
{{end}}

在这个range循环内部，.代表的是Pages切片中的当前整数值（例如1, 2, 3）。此时，直接使用.Name是无效的，因为当前上下文不再是Site结构体，而是切片中的一个int类型元素。这就引出了一个问题：如何在循环内部访问到Site结构体的Name字段？

解决方案：使用根数据对象变量 $

Go模板提供了一个特殊的变量$，它始终指向模板执行时传入的原始数据对象，即根数据上下文。无论当前上下文如何变化（例如进入range循环或with块），$始终保持不变，指向最顶层的数据。

利用$，我们可以在循环内部轻松访问到Site.Name字段。将上述模板修改为：

{{range .Pages}}
    
Page {{.}}
{{end}}

在这里，$.Name明确指示我们访问根数据对象（$）的Name字段。这样，我们就可以在循环中结合当前页码和网站名称来构建完整的URL。

Teleporthq

一体化AI网站生成器，能够快速设计和部署静态网站

下载

示例代码

为了更清晰地展示这一机制，我们提供一个完整的Go程序示例：

package main

import (
    "html/template"
    "os"
    "log"
)

// Site 结构体定义，包含网站名称和页面列表
type Site struct {
    Name  string
    Pages []int
}

func main() {
    // 创建一个 Site 实例作为模板数据
    data := Site{
        Name:  "MyWebsite",
        Pages: []int{1, 2, 3, 4},
    }

    // 定义模板字符串，演示如何在循环中访问根数据对象的字段
    tplContent := `



    


    
Welcome to {{.Name}}
    
Here is a list of our pages:
    

    {{range .Pages}}
        
Page {{.}}
    {{end}}
    

`

    // 解析模板
    tmpl, err := template.New("site_template").Parse(tplContent)
    if err != nil {
        log.Fatalf("Error parsing template: %v", err)
    }

    // 执行模板并将结果输出到标准输出
    err = tmpl.Execute(os.Stdout, data)
    if err != nil {
        log.Fatalf("Error executing template: %v", err)
    }
}

运行上述Go程序，将输出如下HTML内容：

    


    
Welcome to MyWebsite
    
Here is a list of our pages:
    

        
Page 1
        
Page 2
        
Page 3
        
Page 4
    

从输出中可以看到，每个