在go语言的web开发或数据渲染场景中，text/template包是处理html或其他文本输出的强大工具。一个常见的需求是遍历一个包含多个结构体（对象）的切片（数组），并在每次迭代中访问当前结构体的特定字段。例如，你可能有一个category结构体切片，需要显示每个分类的标题和计数。

许多初学者在尝试访问循环中的对象成员时可能会遇到困惑，尤其是在使用非标准或旧版模板语法时。例如，尝试使用{@.Title}这样的表达式通常无法达到预期效果。Go标准库的text/template包提供了一种直观且强大的机制来处理这类场景，其核心在于理解模板上下文（即dot符号，.）在不同作用域中的含义。

理解模板上下文（dot符号）

在Go模板中，{{.}}表示当前的上下文数据。当你在模板的顶层时，{{.}}指向传递给Execute函数的数据。然而，当进入一个循环（如{{range .SliceName}}）时，dot符号的含义会发生变化。在range循环内部，{{.}}不再指向整个数据结构，而是指向当前正在迭代的切片中的单个元素。

因此，如果你正在遍历一个Category结构体切片，并且Category结构体有一个Title字段，那么在循环内部，{{.Title}}将直接访问当前Category元素的Title字段。这就是Go模板处理这类场景的简洁之处。

正确访问循环中的对象成员

要遍历一个对象数组（切片）并访问其成员，应使用{{range .SliceName}}结构。在range块内部，直接使用{{.FieldName}}来访问当前迭代对象的字段。

星绘

豆包旗下 AI 写真、P 图、换装和视频生成

下载

示例代码

以下是一个完整的Go程序示例，演示了如何定义一个结构体，创建一个该结构体类型的切片，并将其传递给模板进行渲染，同时在模板中正确地遍历并访问每个对象的字段：

package main

import (
    "html/template" // 使用 html/template 以处理 HTML 安全输出
    "os"
)

// Category 定义了一个分类结构体
type Category struct {
    Title string
    Count int
}

func main() {
    // 定义模板字符串。
    // {{range .Categories}} 表示遍历传入数据的 "Categories" 字段（一个切片）。
    // 在循环内部，{{.Title}} 和 {{.Count}} 直接访问当前 Category 元素的 Title 和 Count 字段。
    tmplStr := `



    


    
Available Categories:
    

        {{range .Categories}}
            
{{.Title}} ({{.Count}} items)
        {{end}}
    


`
    // 解析模板
    tmpl, err := template.New("categoryList").Parse(tmplStr)
    if err != nil {
        panic(err)
    }

    // 创建 Category 结构体切片作为数据
    categories := []Category{
        {"Programming", 120},
        {"Design", 85},
        {"Marketing", 50},
        {"Data Science", 90},
    }

    // 将数据封装在一个 map 中，以便模板可以通过键 "Categories" 访问
    data := map[string]interface{}{
        "Categories": categories,
    }

    // 执行模板并将结果写入标准输出
    err = tmpl.Execute(os.Stdout, data)
    if err != nil {
        panic(err)
    }
}

运行上述代码，你将得到如下HTML输出：

    


    
Available Categories:
    

        
Programming (120 items)
        
Design (85 items)
        
Marketing (50 items)
        
Data Science (90 items)
    

注意事项与总结

1. 标准模板语法： 始终使用Go标准库text/template（或html/template，推荐用于HTML输出以防止XSS攻击）提供的语法，例如{{range .SliceName}}进行循环，以及{{.FieldName}}来访问字段。避免使用非标准或已废弃的语法，如问题中提到的{.repeated section}。
2. 上下文的动态性： 理解dot符号（.）在模板中是动态变化的，它始终代表当前的上下文数据。在range循环内部，dot符号指向当前迭代的元素。
3. 错误处理： 在实际应用中，解析模板和执行模板时都应进行严格的错误处理，而不是简单地使用panic。
4. 数据封装： 当向模板传递多个变量或复杂数据结构时，通常推荐将它们封装在一个struct或map[string]interface{}中，以便模板可以通过字段名或键名来访问数据。

通过掌握Go模板中上下文（dot）的这一核心概念，开发者可以高效且准确地在模板中处理复杂的数据结构，实现灵活的数据渲染。