Go语言text/template包通过模板语法{{}}结合数据实现动态文本生成，支持变量引用（如{{.Name}}）、控制结构（if/range）、内置及自定义函数（via FuncMap），并可通过define/template实现模板嵌套复用，适用于HTML、配置文件等场景。
Go语言中的text/template包提供了一种强大而灵活的方式来生成文本输出，常用于生成HTML、配置文件、代码模板等。它通过将数据结构与模板结合，实现动态内容渲染。核心思想是：定义模板 → 准备数据 → 执行渲染。
模板基本语法与变量使用
在text/template中，双大括号{{}}表示动作（action），最常见的是变量引用和控制结构。
变量引用：使用{{.}}表示当前上下文的数据，也可以用{{.FieldName}}访问结构体字段。
{{.Name}}今年{{.Age}}岁了。若传入的数据是结构体Person{Name: "张三", Age: 25}，渲染结果为：张三今年25岁了。
立即学习“go语言免费学习笔记（深入）”；
支持的语法还包括：
-
{{.}}：当前作用域的值 -
{{$.Var}}：从根上下文引用变量（跨层级访问） -
{{index .Slice 0}}：访问切片或map元素 -
{{len .Items}}：调用内置函数获取长度
控制结构：条件判断与循环
模板支持常见的流程控制，让输出更具逻辑性。
条件判断使用{{if}}、{{else}}：
{{if .IsAdult}}
你已成年。
{{else}}
你还未成年。
{{end}}循环遍历使用{{range}}：
{{range .Hobbies}}
- {{.}}
{{end}}当.Hobbies是一个字符串切片时，会逐项输出每一项。
在range中还可以使用$index和$value来获取索引和值（需配合赋值）：
{{range $i, $h := .Hobbies}}
{{$i}}: {{$h}}
{{end}}模板函数与自定义函数
text/template支持内置函数如len、printf、eq等，也允许注册自定义函数。
通过template.FuncMap可以添加自己的函数：
funcMap := template.FuncMap{
"upper": strings.ToUpper,
"add": func(a, b int) int { return a + b },
}
tmpl := template.New("demo").Funcs(funcMap)
在模板中即可使用：
{{upper .Name}}
{{add .A .B}}注意：函数必须是可导出的（首字母大写），且参数和返回值类型要匹配。
模板嵌套与复用
大型项目中常需要拆分模板。可以使用{{define}}和{{template}}实现复用。
在一个模板文件中定义多个子模板：
{{define "header"}}
欢迎访问{{.Title}}
{{end}}
{{define "content"}}
内容：{{.Body}}
{{end}}{{define "main"}}
{{template "header" .}}
{{template "content" .}}
{{end}}
渲染时指定主模板名：
tmpl.Lookup("main").Execute(os.Stdout, data)这样可以实现布局分离，提升可维护性。
基本上就这些。掌握变量、控制结构、函数和嵌套后，就能高效使用text/template完成各类文本生成任务。不复杂但容易忽略细节，比如作用域和函数签名限制，实际使用时多测试即可避免问题。
