本文介绍了 go 语言 html/template 包中如何使用 range 关键字进行循环迭代。通过 range 结构，可以方便地遍历切片（slice）、数组（array）或映射（map），从而在模板中动态生成内容。掌握 range 的使用，能够有效提升 Go 模板的灵活性和可维护性。
在 Go 语言的 html/template 包中，虽然没有像其他模板引擎中常见的 for 循环结构，但我们可以使用 range 关键字来实现类似的功能，对切片、数组或映射进行迭代。range 结构允许我们遍历数据集合，并在模板中根据集合中的每个元素动态生成内容。
range 的基本语法
range 的基本语法如下：
{{range <collection>}} ... // 循环体，对集合中的每个元素执行 {{end}}
其中，<collection> 可以是一个切片、数组或映射。在循环体内部，我们可以通过 . (点) 来访问当前迭代的元素。
迭代切片或数组
假设我们有一个包含用户信息的切片：
package main import ( "html/template" "os" ) type User struct { Name string } func main() { users := []User{ {Name: "Alice"}, {Name: "Bob"}, {Name: "Charlie"}, } tmpl, err := template.New("users").Parse(` {{range .}} Hello, {{.Name}}! {{end}} `) if err != nil { panic(err) } err = tmpl.Execute(os.Stdout, users) if err != nil { panic(err) } }
在这个例子中，{{range .}} 表示遍历传递给模板的数据（即 users 切片）。在循环体 Hello, {{.Name}}! 中，.Name 用于访问当前 User 结构体的 Name 字段。运行这段代码，将会输出：
Hello, Alice! Hello, Bob! Hello, Charlie!
迭代映射
range 也可以用于迭代映射。当迭代映射时，range 提供键和值两个变量。
package main import ( "html/template" "os" ) func main() { data := map[string]string{ "name": "John Doe", "email": "john.doe@example.com", } tmpl, err := template.New("data").Parse(` {{range $key, $value := .}} {{$key}}: {{$value}} {{end}} `) if err != nil { panic(err) } err = tmpl.Execute(os.Stdout, data) if err != nil { panic(err) } }
在这个例子中，{{range $key, $value := .}} 表示遍历传递给模板的映射 data。$key 和 $value 分别代表当前迭代的键和值。运行这段代码，将会输出：
email: john.doe@example.com name: John Doe
注意，映射的迭代顺序是不确定的。
else 子句
range 结构还支持一个 else 子句，用于处理集合为空的情况。
{{range <collection>}} ... // 循环体 {{else}} ... // 当集合为空时执行 {{end}}
例如：
package main import ( "html/template" "os" ) func main() { users := []string{} // 空切片 tmpl, err := template.New("users").Parse(` {{range .}} Hello, {{.}}! {{else}} No users found. {{end}} `) if err != nil { panic(err) } err = tmpl.Execute(os.Stdout, users) if err != nil { panic(err) } }
由于 users 切片为空，所以会执行 else 子句，输出 “No users found.”。
注意事项
- 在 range 循环体内，可以通过 . 访问当前迭代的元素。
- 如果需要访问当前迭代的索引，可以使用 range $index, $element := <collection> 的形式。
- range 结构只能用于迭代切片、数组和映射。
- 映射的迭代顺序是不确定的。
- 可以使用 else 子句处理集合为空的情况。
总结
通过 range 结构，Go 模板提供了强大的循环迭代功能。掌握 range 的使用，可以方便地遍历各种数据集合，并在模板中动态生成内容，从而构建更加灵活和可维护的 Web 应用。在实际开发中，应根据具体需求选择合适的数据结构和迭代方式，以达到最佳的性能和可读性。