Golang模板动态填充详解

Go语言的text/template包提供了一种轻量、安全且无需外部依赖的动态文本生成方案，通过定义模板字符串或加载模板文件，结合结构体或map形式的数据传入，再调用Execute方法即可高效渲染出所需内容；它不仅支持基础字段插入，还内置了条件判断、循环遍历、函数管道、HTML安全控制等实用功能，无论是生成配置文件、邮件正文还是命令行输出，都能以简洁清晰的语法实现灵活定制——掌握它，你就能用原生Go轻松驾驭各类动态内容生成场景。

使用 Go 的 text/template 包生成动态文本，核心是定义模板字符串 + 传入数据结构 + 执行渲染。整个过程轻量、安全、无需外部依赖。

定义模板并解析

模板可以是字符串字面量，也可以从文件读取。用 template.New 创建模板对象，再用 Parse 或 ParseFiles 加载内容：

• 字符串模板：直接调用 t, err := template.New("name").Parse("Hello {{.Name}}")
• 文件模板：用 t, err := template.ParseFiles("hello.tmpl")，支持多个文件
• 注意：Parse 会检查语法，若出错必须处理，否则后续 Execute 会 panic

准备要填充的数据

模板中通过 {{.FieldName}} 访问字段，因此数据通常为结构体或 map。推荐用命名结构体，类型安全且可读性高：

• 结构体示例：type User { Name string; Age int }，字段首字母需大写（导出）
• map 示例：data := map[string]interface{}{"Name": "Alice", "Age": 30}
• 支持嵌套：如 {{.Profile.City}} 对应 user.Profile.City

执行渲染并写入目标

调用 Execute 方法将数据注入模板，输出到任意 io.Writer（如 os.Stdout、bytes.Buffer 或文件）：

• err := t.Execute(os.Stdout, user) 直接打印到终端
• var buf bytes.Buffer; t.Execute(&buf, data); result := buf.String() 获取字符串结果
• 若需多次复用同一模板，建议提前 Parse，避免重复解析开销

常用模板语法与技巧

除了基础变量插入，text/template 支持条件、循环、函数调用等：

• 条件判断：{{if .Active}}Online{{else}}Offline{{end}}
• 遍历切片：{{range .Items}}- {{.Name}}{{end}}
• 调用函数：{{.Price | printf "%.2f"}} 或自定义函数（通过 Funcs 注册）
• 避免 HTML 转义（纯文本场景）：{{.RawContent | safeHTML}} 需配合 template.HTML 类型

以上就是《Golang模板动态填充详解》的详细内容，更多关于的资料请关注golang学习网公众号！