当前位置：首页 > 文章列表 > Golang > Go教程 > Go语言模板使用详解

Go语言模板使用详解

2025-12-15 15:13:34 0浏览收藏

积累知识，胜过积蓄金银！毕竟在Golang开发的过程中，会遇到各种各样的问题，往往都是一些细节知识点还没有掌握好而导致的，因此基础知识点的积累是很重要的。下面本文《Go语言text/template使用教程》，就带大家讲解一下知识点，若是你对本文感兴趣，或者是想搞懂其中某个知识点，就请你继续往下看吧~

使用text/template可动态生成文本，通过template.New或ParseFiles创建模板，用{{.FieldName}}引用数据，支持if和range控制结构，结合数据结构渲染输出。

如何在Golang中使用text/template生成文本模板

在Golang中，text/template 包用于生成基于模板的文本输出，常用于生成配置文件、邮件内容、代码生成等场景。它通过将数据结构与模板字符串结合，动态渲染出最终文本。

定义模板

使用 template.New 创建一个新模板，或用 template.Must 简化错误处理。模板内容可以内嵌在代码中，也可以从文件加载。

示例：

package main
import (
"os"
"text/template"
)
func main() {
const templateText = "Hello, {{.Name}}! You are {{.Age}} years old.\n"
tmpl := template.Must(template.New("example").Parse(templateText))

data := struct {
    Name string
    Age  int
}{
    Name: "Alice",
    Age: 25,
}

tmpl.Execute(os.Stdout, data)
}

运行结果：
Hello, Alice! You are 25 years old.

模板中的数据引用

在模板中使用 {{.FieldName}} 引用结构体字段，{{.}} 表示当前上下文的数据本身。

支持以下语法：

{{.Name}}：访问字段
{{.}}：整个数据对象
{{index .Slice 0}}：访问切片元素
{{.Map.key}}：访问 map 的键

示例数据结构：

data := map[string]interface{}{
    "Title": "My Page",
    "Items": []string{"apple", "banana"},
    "Config": map[string]string{
        "lang": "en",
    },
}

对应模板：

{{.Title}}
{{range .Items}}- {{.}}\n{{end}}
Language: {{.Config.lang}}

控制结构：if 和 range

模板支持逻辑控制，如条件判断和循环。

if：根据值是否存在或为真执行内容
range：遍历数组、切片或 map

示例：

{{if .Email}}
User email: {{.Email}}
{{else}}
No email provided.
{{end}}
Items:
{{range .Items}}

{{.}} {{end}}

从文件加载模板

实际项目中，模板通常放在单独的文件中。使用 template.ParseFiles 加载文件。

假设有一个文件 greeting.tmpl：

Hello {{.Name}},
Welcome to {{.Site}}!

Go 代码加载并执行：

tmpl, err := template.ParseFiles("greeting.tmpl")
if err != nil {
    log.Fatal(err)
}
tmpl.Execute(os.Stdout, map[string]string{
    "Name": "Bob",
    "Site": "OurApp",
})

基本上就这些。掌握数据绑定、控制结构和文件加载，就能灵活使用 text/template 生成所需文本。

今天关于《Go语言模板使用详解》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！