登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  Golang >  Go教程

Golang模板渲染教程与代码示例

时间：2026-05-28 15:54:31 459浏览 收藏

Go语言的text/template包提供了一套简洁而强大的文本模板渲染机制，通过{{}}语法将结构化数据（如结构体、切片、map）动态注入模板，支持变量访问（如{{.Name}}）、条件判断（{{if}}{{else}}{{end}}）、循环遍历（{{range}}{{end}}）以及自定义函数扩展（如注册mail函数生成格式化邮箱），广泛应用于HTML页面生成、配置文件渲染、代码模板等场景；文中的完整示例清晰展示了从定义模板、准备数据到执行渲染的全流程，让开发者能快速上手并高效构建动态文本输出能力。

Golangtemplate文本模板渲染与使用示例

Go语言中的text/template包提供了一种强大而灵活的方式来生成文本输出，常用于生成HTML、配置文件、源代码等。模板通过将数据结构与模板字符串结合，动态渲染出最终的文本内容。

模板基本语法与变量引用

在Go模板中，使用双大括号{{}}来插入变量或执行操作。根对象用.表示，可以访问结构体字段、map键值、切片元素等。

例如：

Hello, {{.Name}}! You are {{.Age}} years old.

对应的数据结构：

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

渲染时，.Name和.Age会被替换为实际值。

控制结构：条件判断与循环

模板支持if、range等控制语句，用于处理逻辑分支和遍历数据。

示例模板：

{{if .LoggedIn}}
Welcome back, {{.UserName}}!
{{else}}
Please log in.
{{end}}
    {{range .Items}}
  • {{.}}
    • {{end}}

当LoggedIn为true时显示欢迎信息，否则提示登录。range用于遍历Items切片并生成列表项。

函数调用与自定义函数

可以在模板中调用预定义或自定义函数。Go模板允许注册函数映射（FuncMap），扩展模板能力。

示例：

func formatEmail(email string) string {
    return "" + email + ""
}

funcMap := template.FuncMap{
"mail": formatEmail,
}
t := template.New("example").Funcs(funcMap)
t, _ = t.Parse("Contact: {{mail .Email}}")

注册一个mail函数后，可在模板中直接使用{{mail .Email}}生成邮件链接。

完整使用示例

下面是一个完整的程序示例：

package main

import (
"os"
"text/template"
)
type User struct {
Name  string
Admin bool
Posts []string
}
func main() {
const tmpl = `
Hello {{.Name}},
You are {{if .Admin}}an admin{{else}}a regular user{{end}}.
Your posts:
{{range .Posts}}- {{.}}
{{end}}
`
user := User{
    Name:  "Bob",
    Admin: true,
    Posts: []string{"First post", "Go templates"},
}

t := template.Must(template.New("user").Parse(tmpl))
t.Execute(os.Stdout, user)
}

运行结果：

Hello Bob,
You are an admin.

Your posts:
  • First post
  • Go templates

基本上就这些。掌握变量引用、控制结构和自定义函数，就能高效使用Go的文本模板功能。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Golang模板渲染教程与代码示例》文章吧，也可关注golang学习网公众号了解相关技术文章。

相关阅读
更多>
最新阅读
更多>
课程推荐
更多>