本文介绍了 Go 语言 html/template 包中如何使用 range 关键字进行循环迭代。通过 range 结构，可以方便地遍历切片（slice）、数组（array）或映射（map），从而在模板中动态生成内容。掌握 range 的使用，能够有效提升 Go 模板的灵活性和可维护性。
在 Go 语言的 html/template 包中，虽然没有像其他模板引擎中常见的 for 循环结构，但我们可以使用 range 关键字来实现类似的功能，对切片、数组或映射进行迭代。range 结构允许我们遍历数据集合，并在模板中根据集合中的每个元素动态生成内容。
range 的基本语法
range 的基本语法如下：
{{range }}
... // 循环体，对集合中的每个元素执行
{{end}} 其中，
迭代切片或数组
假设我们有一个包含用户信息的切片：
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 }}
... // 循环体
{{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 :=
的形式。 - range 结构只能用于迭代切片、数组和映射。
- 映射的迭代顺序是不确定的。
- 可以使用 else 子句处理集合为空的情况。
总结
通过 range 结构，Go 模板提供了强大的循环迭代功能。掌握 range 的使用，可以方便地遍历各种数据集合，并在模板中动态生成内容，从而构建更加灵活和可维护的 Web 应用。在实际开发中，应根据具体需求选择合适的数据结构和迭代方式，以达到最佳的性能和可读性。
