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 或文件):
立即学习“go语言免费学习笔记(深入)”;
-
err := t.Execute(os.Stdout, user)直接打印到终端 -
var buf bytes.Buffer; t.Execute(&buf, data); result := buf.String()获取字符串结果 - 若需多次复用同一模板,建议提前
Parse,避免重复解析开销
常用模板语法与技巧
除了基础变量插入,text/template 支持条件、循环、函数调用等: