Go 模板中的循环结构：使用 range 迭代-Golang-PHP中文网

Go 模板中的循环结构：使用 range 迭代

花韻仙語

发布： 2025-09-23 18:09:33

原创

237人浏览过

go 模板中的循环结构：使用 range 迭代

本文介绍了 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 提供键和值两个变量。

AiPPT模板广场

AiPPT模板广场-PPT模板-word文档模板-excel表格模板

147

查看详情

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."。