如何使用Golang text/template生成文本内容_动态填充模板数据

25次阅读

go 的 text/template 包通过定义模板字符串、传入数据结构、执行渲染生成动态文本,轻量安全;支持字符串或文件解析模板,用结构体map 传参,提供条件判断、循环遍历等语法。

如何使用Golang text/template生成文本内容_动态填充模板数据

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

定义模板并解析

模板可以是字符串字面量,也可以从文件读取。用 template.New 创建模板对象,再用 ParseParseFiles 加载内容:

  • 字符串模板:直接调用 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.Stdoutbytes.Buffer 或文件):

立即学习go语言免费学习笔记(深入)”;

  • 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 类型
text=ZqhQzanResources