理解 Go 模板的上下文与迭代
在 go 语言的 html/template 或 text/template 包中，模板渲染的核心概念是“上下文”（context），它由 . 符号表示。当模板引擎执行到不同的代码块时，这个上下文会动态地发生变化。
对于遍历数组或切片（Slice）的场景，Go 模板提供了 {{range .SliceName}}...{{end}} 结构。例如，如果您的数据结构中包含一个名为 Categories 的切片，您会这样写：
{{range .Categories}}
{{end}}关键点在于上下文的切换： 当 range 循环开始迭代 Categories 切片时，在 {{range}} 和 {{end}} 之间的代码块中，当前的上下文 . 不再是传递给模板的整个数据对象，而是切片中的每一个单独的元素。这意味着，如果您正在遍历一个 Category 结构体切片，那么在循环内部，. 就代表了当前的 Category 实例。
因此，一些初学者可能会尝试使用类似 {@.Title} 或 {{.Category.Title}} 这样的语法来访问字段。然而，这通常是错误的，因为 . 已经直接指向了 Category 对象本身。{@} 这种语法也并非 Go 模板的标准用法。
正确访问结构体成员
鉴于上述上下文切换的机制，访问当前结构体元素的成员变量变得非常直观。您只需使用 {{.FieldName}} 的形式即可。模板引擎会在当前的上下文（即循环中的单个结构体实例）中查找名为 FieldName 的字段。
例如，如果您的 Category 结构体定义如下：
type Category struct {
Title string
Count int
}当您在 range 循环内部时，要访问 Title 字段，只需写 {{.Title}}；要访问 Count 字段，则写 {{.Count}}。
实战示例
下面是一个完整的 Go 程序示例，演示了如何在模板中遍历一个 Category 结构体切片并访问其成员：
package main
import (
"html/template" // 也可以使用 "text/template"
"os"
)
// 定义 Category 结构体
type Category struct {
Title string
Count int
}
func main() {
// 定义模板字符串
// 注意：这里使用了 {{range .Categories}} 作为标准的 Go 模板遍历语法
// 并且直接使用 {{.Title}} 和 {{.Count}} 访问字段
tmplStr := `
Categories List
商品分类
-
{{range .Categories}}
- {{.Title}} (商品数量: {{.Count}}) {{else}}
- 暂无分类数据。 {{end}}
运行上述代码，您将得到以下 HTML 输出：
Categories List
商品分类
- 电子产品 (商品数量: 120)
- 图书音像 (商品数量: 85)
- 服饰鞋包 (商品数量: 210)
- 家居用品 (商品数量: 95)
注意事项与最佳实践
- 错误处理： 在生产环境中，template.New().Parse() 和 tmpl.Execute() 都可能返回错误。务必对这些错误进行适当的检查和处理，而不是简单地使用 panic()。
- 模板语法： Go 模板的标准语法是 {{...}}。请避免使用其他模板引擎的语法（如 {.repeated section ...} 或 {@}），以免造成混淆或错误。
- 上下文的灵活性： 除了访问结构体字段，{{.}} 也可以用来访问当前上下文本身（如果它是一个基本类型，如字符串或整数），或者调用当前上下文的方法（如果方法是公开的且没有参数）。
- html/template vs text/template： 如果您正在生成 HTML 内容，强烈建议使用 html/template 包。它会自动对输出进行 HTML 转义，从而有效防止跨站脚本攻击（XSS）。如果只是生成纯文本，则可以使用 text/template。
- 空切片处理： {{range}} 结构支持 {{else}} 子句，当遍历的切片为空时，else 块中的内容会被渲染，这对于提供友好的用户体验非常有用，如示例中所示。
通过理解 Go 模板的上下文机制和 range 循环的工作原理，您可以高效且安全地在模板中处理复杂的数据结构，生成清晰且功能强大的动态内容。
