Go 语言的 html/template 包提供了强大的模板渲染功能，允许开发者将数据动态地嵌入到 HTML 或其他文本格式中。虽然模板引擎提供了条件判断（if）等控制结构，但循环结构同样至关重要，尤其是在处理集合数据时。本文将详细介绍如何在 Go 模板中使用 range 关键字来迭代切片或数组。

range 的基本用法

range 关键字是 Go 模板中实现循环的主要方式。它允许你遍历一个切片或数组，并在每次迭代中访问当前元素。其基本语法如下：

{{range 集合}}
  {{.}}  
{{end}}

其中，集合 可以是一个切片、数组或映射。在循环体内部，{{.}} 表示当前元素。

迭代切片并访问元素属性

当集合中的元素是结构体时，你可以使用点号（.）来访问元素的属性。例如，假设我们有一个包含 Person 结构体的切片：

package main

import (
    "html/template"
    "os"
)

type Person struct {
    Name string
    Age  int
}

func main() {
    people := []Person{
        {Name: "Alice", Age: 30},
        {Name: "Bob", Age: 25},
        {Name: "Charlie", Age: 35},
    }

    tmpl, err := template.New("people").Parse(`
    
    
    
        
    
    
        
People List
        

            {{range .}}
                
Name: {{.Name}}, Age: {{.Age}}
            {{end}}
        
    
    
    `)
    if err != nil {
        panic(err)
    }

    err = tmpl.Execute(os.Stdout, people)
    if err != nil {
        panic(err)
    }
}

在这个例子中，{{.Name}} 和 {{.Age}} 分别访问了 Person 结构体的 Name 和 Age 字段。运行这段代码，将会输出一个包含人员列表的 HTML 页面。

迭代切片并获取索引和值

range 还可以同时提供索引和值。这在某些情况下非常有用，例如需要显示列表的序号。语法如下：

{{range $index, $element := 集合}}
  Index: {{$index}}, Element: {{$element}}
{{end}}

在这个语法中，$index 是当前元素的索引，$element 是当前元素的值。可以将上述例子修改为同时显示索引：

package main

import (
    "html/template"
    "os"
)

type Person struct {
    Name string
    Age  int
}

func main() {
    people := []Person{
        {Name: "Alice", Age: 30},
        {Name: "Bob", Age: 25},
        {Name: "Charlie", Age: 35},
    }

    tmpl, err := template.New("people").Parse(`
    
    
    
        
    
    
        
People List
        

            {{range $index, $person := .}}
                
Index: {{$index}}, Name: {{$person.Name}}, Age: {{$person.Age}}
            {{end}}
        
    
    
    `)
    if err != nil {
        panic(err)
    }

    err = tmpl.Execute(os.Stdout, people)
    if err != nil {
        panic(err)
    }
}

注意事项

• 变量作用域： 在 range 循环内部定义的变量（如 $index 和 $element）只在循环体内部有效。
• 空切片处理： 如果要迭代的切片为空，range 循环体将不会执行。你可以使用 if 语句来判断切片是否为空，并采取相应的处理。
• 避免修改集合： 在 range 循环内部修改正在迭代的切片或数组可能会导致不可预测的结果，应尽量避免。

总结

range 关键字是 Go 模板中进行循环迭代的关键。通过灵活运用 range，可以方便地遍历切片、数组和映射，并在模板中动态地生成内容。理解 range 的用法和注意事项，能够帮助你编写更高效、更可维护的 Go 模板代码。希望本文提供的示例和说明能够帮助你更好地掌握 Go 模板中的循环结构。