Golang text/template模板渲染与使用实践

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等，也允许注册自定义函数。

AiPPT模板广场

AiPPT模板广场-PPT模板-word文档模板-excel表格模板

147

查看详情

通过template.FuncMap可以添加自己的函数：

funcMap := template.FuncMap{
    "upper": strings.ToUpper,
    "add":   func(a, b int) int { return a + b },
}
<p>tmpl := template.New("demo").Funcs(funcMap)

在模板中即可使用：

{{upper .Name}}
{{add .A .B}}

注意：函数必须是可导出的（首字母大写），且参数和返回值类型要匹配。

模板嵌套与复用

大型项目中常需要拆分模板。可以使用{{define}}和{{template}}实现复用。

在一个模板文件中定义多个子模板：

{{define "header"}}
<div class="header">欢迎访问{{.Title}}</div>
{{end}}
<p>{{define "content"}}
<p>内容：{{.Body}}</p>
{{end}}</p><p>{{define "main"}}
{{template "header" .}}
{{template "content" .}}
{{end}}

渲染时指定主模板名：

tmpl.Lookup("main").Execute(os.Stdout, data)

这样可以实现布局分离，提升可维护性。

基本上就这些。掌握变量、控制结构、函数和嵌套后，就能高效使用text/template完成各类文本生成任务。不复杂但容易忽略细节，比如作用域和函数签名限制，实际使用时多测试即可避免问题。

以上就是Golang text/template模板渲染与使用实践的详细内容，更多请关注php中文网其它相关文章！