本文详解如何在 Go 的 text/template 中正确遍历结构体切片（[]struct），并通过 range 动作访问每个结构体字段，实现清晰、安全的 HTML 或文本渲染。

本文详解如何在 go 的 `text/template` 中正确遍历结构体切片（`[]struct`），并通过 `range` 动作访问每个结构体字段，实现清晰、安全的 html 或文本渲染。

Go 模板不支持直接索引访问切片（如 .List[0].ID），必须使用 range 动作进行迭代。核心要点是：range 可同时绑定索引和元素变量，推荐显式命名以提升可读性与维护性。

以下是一个标准、可运行的示例：

package main

import (
    "fmt"
    "os"
    "text/template"
)

type MyType struct { // 注意：字段名首字母大写才能导出（模板中可访问）
    ID   string
    Name string
    Test string
}

func main() {
    list := []MyType{
        {"id1", "name1", "test1"},
        {"id2", "name2", "test2"},
    }

    tmpl := `

{{range $index, $item := .}} {{end}}

{{ $item.ID }}

{{ $item.Name }}

{{ $item.Test }}

` t := template.Must(template.New("list").Parse(tmpl)) if err := t.Execute(os.Stdout, list); err != nil { fmt.Fatal("模板执行失败:", err) } }

✅ 关键说明：

使用Go语言搭建家庭相册系统-相关课件

使用Go语言搭建家庭相册系统-相关课件

下载

• . 在 range 中代表传入的根数据（即 []MyType 切片）；
• {{range $index, $item := .}} 中 $index 是当前索引（可省略，用 _ 占位），$item 是当前结构体实例；
• 所有结构体字段必须是导出字段（首字母大写），否则模板无法访问（如原问题中 Name 和 Test 缺少类型声明且未导出，会导致渲染为空）；
• 若只需元素无需索引，可简写为 {{range .}}，此时 . 指向当前结构体，可直接写 {{.ID}}；但显式命名（如 $item.ID）更利于嵌套模板与逻辑扩展。

⚠️ 常见陷阱提醒：

• 忘记字段导出 → 模板中输出为空字符串；
• 使用未定义变量（如 {{.Name}} 在 range 外作用域无效）；
• 混淆 . 的上下文：在 range 内部 . 指当前元素，外部 . 指传入的整个切片；
• 未处理空切片 → range 会自然跳过，安全，但建议前端加 {{if .}}...{{else}}暂无数据{{end}} 提升用户体验。

掌握 range 与结构体字段访问，即可高效构建动态列表、表格、卡片等模板场景，是 Go Web 开发与 CLI 工具生成内容的基础能力。