使用 Go 模板引擎动态渲染 HTML 表格（支持结构体切片循环）-Golang-PHP中文网

本文详解如何利用 Go 的 html/template 包，通过 {{range}} 动作动态渲染未知长度的结构体切片，生成包含多行数据的 HTML 表格，涵盖模板语法、数据绑定、安全转义及常见实践要点。

本文详解如何利用 go 的 `html/template` 包，通过 `{{range}}` 动作动态渲染未知长度的结构体切片，生成包含多行数据的 html 表格，涵盖模板语法、数据绑定、安全转义及常见实践要点。

在 Go Web 开发中，将结构化数据（如 []struct{}）动态渲染为 HTML 表格是高频需求。Go 原生的 html/template 提供了简洁而强大的 {{range}}...{{end}} 控制结构，专为遍历切片、数组或映射设计，无需预知元素数量即可完成逐项渲染。

以下是一个完整可运行示例，展示如何渲染一个包含玩家得分的 HTML 有序列表（可轻松扩展为

anything-to-html

将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。

下载

）：

package main

import (
    "html/template"
    "log"
    "os"
)

type Highscore struct {
    Name  string
    Score int
}

func main() {
    const tpl = `

玩家姓名	得分
{{.Name}}	{{.Score}}
暂无数据

` scores := []Highscore{ {"Steve", 50}, {"Jim", 40}, {"Alice", 92}, } t, err := template.New("highscore").Parse(tpl) if err != nil { log.Fatal("解析模板失败：", err) } if err := t.Execute(os.Stdout, scores); err != nil { log.Fatal("执行模板失败：", err) } }

关键要点说明：

{{range .}} 中的 . 表示传入模板的顶层数据（即 scores 切片），每次迭代时 . 自动指向当前结构体元素（如 Highscore{"Steve", 50}），因此 {{.Name}} 和 {{.Score}} 可直接访问字段。
支持 {{else}} 子句：当切片为空时，自动渲染 {{else}} 内容，提升用户体验与健壮性。
html/template 默认对输出内容进行 HTML 转义（如
模板可分离为独立 .html 文件，用 template.ParseFiles("table.html") 加载，便于维护与复用。
若需嵌套结构（如每个玩家含多个子项），可在 {{range}} 内部再次使用 {{range .Items}}，实现多层动态渲染。

掌握 {{range}} 是构建动态 HTML 页面的核心能力——它让 Go 模板既安全又灵活，完美适配服务端渲染场景。