17370845950

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

使用 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 类型