Golang中模板渲染依赖text/template和html/template包，前者用于纯文本，后者支持HTML自动转义以防范XSS攻击。可通过字符串或文件定义模板，如使用Parse解析字符串或ParseFiles加载文件。模板占位符如{{.Name}}对应数据结构字段，且字段需大写开头才可导出。html/template会自动转义特殊字符，增强安全性。支持if、range等逻辑控制，实现条件判断与循环输出。通过define和template指令可定义并嵌套子模板，实现布局复用，适用于多页面应用。典型应用场景包括HTML页面、配置文件和邮件内容生成，结合结构体与控制语句，简洁高效且安全可靠。
在Golang中实现模板渲染主要依赖标准库中的 text/template 和 html/template 包。前者适用于纯文本模板，后者专为HTML设计，具备自动转义功能，防止XSS攻击。下面介绍如何使用它们完成常见场景下的模板渲染。
定义和解析模板
你可以通过字符串或文件来定义模板内容。
使用字符串定义模板：
package main
import (
"os"
"text/template"
)
func main() {
const tpl = `Hello, {{.Name}}! You are {{.Age}} years old.`
t := template.Must(template.New("example").Parse(tpl))
data := struct {
Name string
Age int
}{
Name: "Alice",
Age: 25,
}
t.Execute(os.Stdout, data)
}
这段代码会输出：Hello, Alice! You are 25 years old.
立即学习“go语言免费学习笔记（深入）”；
.Name 和 .Age 是模板中的占位符，对应传入数据结构的字段。
从文件加载模板
实际项目中模板通常放在独立文件中。假设有一个文件 hello.tmpl：
Welcome, {{.UserName}}
You have {{.MessageCount}} new messages.
用 html/template 读取并渲染：
package main
import (
"html/template"
"log"
"os"
)
func main() {
t, err := template.ParseFiles("hello.tmpl")
if err != nil {
log.Fatal("Parse error:", err)
}
data := struct {
UserName string
MessageCount int
}{
UserName: "Bob",
MessageCount: 3,
}
t.Execute(os.Stdout, data)
}
注意这里使用的是 html/template，它会对输出自动进行HTML转义，比如如果 UserName 包含
使用条件和循环
模板支持逻辑控制，如 if、range 等。
示例模板（users.tmpl）：
一套面向小企业用户的企业网站程序！功能简单，操作简单。实现了小企业网站的很多实用的功能，如文章新闻模块、图片展示、产品列表以及小型的下载功能，还同时增加了邮件订阅等相应模块。公告，友情链接等这些通用功能本程序也同样都集成了！同时本程序引入了模块功能，只要在系统默认模板上创建模块，可以在任何一个语言环境（或任意风格）的适当位置进行使用！
-
{{range .Users}}
- {{.}} {{end}}
You are an admin.
{{end}}Go代码：
data := struct {
Users []string
Admin bool
}{
Users: []string{"Alice", "Bob", "Charlie"},
Admin: true,
}
t, _ := template.ParseFiles("users.tmpl")
t.Execute(os.Stdout, data)
这会生成一个用户列表，并显示管理员提示。
嵌套模板与复用
可以定义多个子模板并嵌套使用，适合构建页面布局。
例如 layout.tmpl：
{{template "title" .}} {{template "content" .}}
home.tmpl：
{{define "title"}}Home{{end}}
{{define "content"}}
Home Page
Welcome to our site!
{{end}}
加载多个模板文件：
t, _ := template.ParseFiles("layout.tmpl", "home.tmpl")
t.ExecuteTemplate(os.Stdout, "layout", nil)
这样就能实现页面结构复用，适合多页面应用。
基本上就这些。Golang的模板系统简洁实用，结合结构体和控制语句，足以满足大多数渲染需求，尤其适合生成HTML、配置文件或邮件内容。安全性和可维护性都不错，是Web开发中的常用工具。不复杂但容易忽略细节，比如字段必须可导出（大写开头），否则模板拿不到值。
