Go语言模板入门指南（text/template基础使用详解）

什么是 text/template？

text/template 是 Go 语言标准库中的一个包，专门用于处理纯文本模板。它允许你定义带有占位符的模板，并通过传入数据结构（如结构体、map 等）来动态填充内容。

与 html/template 不同，text/template 不会对 HTML 特殊字符进行转义，因此更适合处理非 HTML 的纯文本场景。

第一个 text/template 示例

让我们从一个最简单的例子开始：

package mainimport (    "os"    "text/template")type Person struct {    Name string    Age  int}func main() {    // 定义模板字符串    tmplStr := "你好，{{.Name}}！你今年 {{.Age}} 岁了。"    // 创建模板    tmpl, err := template.New("example").Parse(tmplStr)    if err != nil {        panic(err)    }    // 准备数据    p := Person{Name: "小明", Age: 25}    // 执行模板并输出到标准输出    err = tmpl.Execute(os.Stdout, p)    if err != nil {        panic(err)    }}

运行这段代码，你会看到输出：

你好，小明！你今年 25 岁了。

这里我们使用了 {{.Name}} 和 {{.Age}} 作为模板中的占位符，它们会自动从传入的 Person 结构体中提取对应字段的值。

常用模板语法

除了简单的字段引用，text/template 还支持条件判断、循环等控制结构。

1. 条件语句（if/else）

tmplStr := `{{if .IsAdult}}你已成年。{{else}}你还未成年。{{end}}`// 数据p := map[string]interface{}{    "IsAdult": true,}

2. 循环（range）

tmplStr := `水果清单：{{range .Fruits}}- {{.}}{{end}}`// 数据data := map[string][]string{    "Fruits": {"苹果", "香蕉", "橙子"},}

输出结果：

水果清单：- 苹果- 香蕉- 橙子

为什么选择 Go 模板引擎？

Go语言模板系统（包括 text/template 和 html/template）具有以下优势：

• ✅ 内置于标准库，无需额外依赖
• ✅ 语法简洁，学习成本低
• ✅ 类型安全，编译时即可发现部分错误
• ✅ 支持自定义函数和管道操作

总结

通过本教程，你应该已经掌握了 Go文本模板 的基本用法。无论是生成配置文件、日志消息，还是自动化报告，text/template 都是一个强大而灵活的工具。

记住，熟练掌握 Go语言模板 能让你的程序更加动态和可维护。建议多动手实践，尝试组合不同的模板语法，逐步提升你的 Go模板引擎 使用技巧！

关键词回顾：Go语言模板、text/template、Go模板引擎、Go文本模板