go语言中text/template包用于动态生成文本，支持变量替换、条件判断、循环及自定义函数。通过Parse解析模板字符串，Execute将数据写入io.Writer。结构体字段需首字母大写以导出，.Name等占位符对应字段值。使用{{if}}进行条件控制，{{range}}遍历切片或map。可嵌套访问字段如{{.User.Name}}。通过FuncMap注册函数并用|管道调用，如{{.Name | upper}}。利用{{define}}和{{template}}实现模板复用。建议结合template.Must和错误处理确保安全。
在Go语言中，text/template 包提供了一种强大且灵活的方式来生成文本内容。无论是生成html页面、配置文件、邮件模板，还是自动化脚本内容，都可以通过模板引擎完成。它支持变量替换、条件判断、循环结构和自定义函数等特性，非常适合用于动态文本生成。
基本用法：定义模板与数据渲染
使用 text/template 的第一步是定义一个模板字符串或从文件加载模板，然后将数据传入并执行渲染。
示例代码：
package main <p>import ( "os" "text/template" )</p><p>type User struct { Name string Email string }</p><p>func main() { const templateStr = "Hello, {{.Name}}! Your email is {{.Email}}."</p><pre class='brush:php;toolbar:false;'>t := template.Must(template.New("user").Parse(templateStr)) user := User{Name: "Alice", Email: "alice@example.com"} _ = t.Execute(os.Stdout, user)
}
立即学习“go语言免费学习笔记（深入）”；
输出结果：
Hello, Alice! Your email is alice@example.com.
.Name 和 .Email 是模板中的占位符，对应结构体字段。注意模板通过 Execute 方法将数据写入目标 io.Writer（如 os.Stdout）。
控制结构：if、range 等逻辑处理
模板支持常见的控制结构，可用于处理复杂数据逻辑。
常用语法包括：
- {{if .Condition}}…{{end}}：条件判断
- {{if .Condition}}…{{else}}…{{end}}：带 else 分支
- {{range .Items}}…{{end}}：遍历切片或map
- {{range .Items}}{{.}} {{end}}：直接输出每个元素
示例：渲染用户列表
const tmpl = ` Users: {{range .}} - Name: {{.Name}}, Email: {{.Email}} {{end}} ` <p>users := []User{ {Name: "Bob", Email: "bob@example.com"}, {Name: "Charlie", Email: "charlie@example.com"}, }</p><p>t := template.Must(template.New("users").Parse(tmpl)) _ = t.Execute(os.Stdout, users)</p>
输出：
Users:
-
Name: Bob, Email: bob@example.com
-
Name: Charlie, Email: charlie@example.com
嵌套结构与字段访问
模板可以访问结构体的嵌套字段，使用点号逐级访问。
例如：
type Profile struct { User User Age int City string } <p>const nestedTmpl = "Hi {{.User.Name}}, you are {{.Age}} years old and live in {{.City}}."</p>
模板中通过 {{.User.Name}} 访问嵌套字段，只要字段可导出（首字母大写），就能被模板读取。
自定义函数：扩展模板能力
有时内置语法不够用，可以通过 FuncMap 注册自定义函数。
示例：添加一个转大写的函数
funcMap := template.FuncMap{ "upper": strings.ToUpper, } <p>t := template.New("withFunc").Funcs(funcMap) t, _ = t.Parse("Hello {{.Name | upper}}!")</p><p>_ = t.Execute(os.Stdout, User{Name: "dave"})</p>
输出：Hello DAVE!
这里使用了管道符 | 将值传递给 upper 函数。自定义函数极大增强了模板的表达能力，比如格式化时间、拼接字符串、条件计算等。
模板组合：使用 define 和 template 指令
大型项目中常需要复用模板片段。可通过 define 定义命名模板，并用 template 引入。
示例：
const master = ` {{define "Greet"}}Hello, {{.Name}}{{end}} <p>{{template "Greet" .}} Welcome to our system! `</p><p>t, _ := template.New("master").Parse(master) t.Execute(os.Stdout, User{Name: "Eve"})</p>
这种机制适合构建布局模板、页眉页脚等可复用组件。
基本上就这些。掌握 text/template 的核心语法和使用模式后，你可以在各种场景中高效生成结构化文本。关键是理解数据如何传递到模板，以及如何用简洁的语法控制输出格式。不复杂但容易忽略细节，比如字段导出、方法签名匹配、错误处理等，建议结合 template.Must 和 proper Error checks 在生产中使用。