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

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

聖光之護

发布： 2025-09-23 17:44:48

原创

901人浏览过

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

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(`
    <!DOCTYPE html>
    <html>
    <head>
        <title>People</title>
    </head>
    <body>
        <h1>People List</h1>
        <ul>
            {{range .}}
                <li>Name: {{.Name}}, Age: {{.Age}}</li>
            {{end}}
        </ul>
    </body>
    </html>
    `)
    if err != nil {
        panic(err)
    }

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

登录后复制

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

AiPPT模板广场

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

147

查看详情

迭代切片并获取索引和值

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(`
    <!DOCTYPE html>
    <html>
    <head>
        <title>People</title>
    </head>
    <body>
        <h1>People List</h1>
        <ul>
            {{range $index, $person := .}}
                <li>Index: {{$index}}, Name: {{$person.Name}}, Age: {{$person.Age}}</li>
            {{end}}
        </ul>
    </body>
    </html>
    `)
    if err != nil {
        panic(err)
    }

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

登录后复制