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：
<h1>Welcome, {{.UserName}}</h1>
<p>You have {{.MessageCount}} new messages.</p>
用 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 包含 <script>，会被转成实体字符，提高安全性。</script>
使用条件和循环
模板支持逻辑控制，如 if、range 等。
示例模板（users.tmpl）：
<ul>
{{range .Users}}
<li>{{.}}</li>
{{end}}
</ul>
{{if .Admin}}
<p><strong>You are an admin.</strong></p>
{{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：
<!DOCTYPE html>
<html>
<head><title>{{template "title" .}}</title></head>
<body>
{{template "content" .}}
</body>
</html>
home.tmpl：
{{define "title"}}Home{{end}}
{{define "content"}}
<h1>Home Page</h1>
<p>Welcome to our site!</p>
{{end}}
加载多个模板文件：
t, _ := template.ParseFiles("layout.tmpl", "home.tmpl")
t.ExecuteTemplate(os.Stdout, "layout", nil)
这样就能实现页面结构复用，适合多页面应用。
基本上就这些。Golang的模板系统简洁实用，结合结构体和控制语句，足以满足大多数渲染需求，尤其适合生成HTML、配置文件或邮件内容。安全性和可维护性都不错，是Web开发中的常用工具。不复杂但容易忽略细节，比如字段必须可导出（大写开头），否则模板拿不到值。
