在Golang的Web开发过程中，动态页面的生成往往需要借助模板渲染能力，标准库自带的html/template包提供了安全且易用的模板引擎功能，能够满足大部分Web场景的页面渲染需求。
Golang模板引擎基础使用步骤
使用html/template包实现模板渲染主要分为三个核心步骤，分别是定义模板、解析模板、执行模板渲染，下面逐一说明每个步骤的具体操作。
1. 定义模板文件
模板文件通常以.tmpl或者.html为后缀，内部可以编写HTML结构，同时嵌入模板语法来动态填充数据。下面是一个简单的模板文件示例，保存为index.tmpl：
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>{{.Title}}</title>
</head>
<body>
<h1>欢迎来到{{.SiteName}}</h1>
<p>当前时间：{{.CurrentTime}}</p>
</body>
</html>
2. 解析模板文件
在Go代码中需要先导入html/template包，然后通过ParseFiles或者ParseGlob方法解析模板文件，解析成功后会得到一个模板对象。
package main
import (
"html/template"
"log"
)
func main() {
// 解析单个模板文件
tpl, err := template.ParseFiles("index.tmpl")
if err != nil {
log.Fatalf("解析模板失败：%v", err)
}
// 后续可以使用tpl对象进行渲染
}
3. 执行模板渲染
解析得到模板对象后，可以调用Execute方法，传入输出的目标（比如http.ResponseWriter）和要绑定的数据，完成模板渲染。数据可以是结构体、map等类型，模板中通过{{.字段名}}的方式获取对应的值。
package main
import (
"html/template"
"log"
"net/http"
"time"
)
// 定义绑定数据的结构体
type PageData struct {
Title string
SiteName string
CurrentTime string
}
func indexHandler(w http.ResponseWriter, r *http.Request) {
// 解析模板
tpl, err := template.ParseFiles("index.tmpl")
if err != nil {
log.Fatalf("解析模板失败：%v", err)
}
// 准备渲染数据
data := PageData{
Title: "首页",
SiteName: "示例站点",
CurrentTime: time.Now().Format("2006-01-02 15:04:05"),
}
// 执行渲染，将结果写入ResponseWriter
err = tpl.Execute(w, data)
if err != nil {
log.Fatalf("渲染模板失败：%v", err)
}
}
func main() {
http.HandleFunc("/", indexHandler)
log.Println("服务启动在 :8080")
err := http.ListenAndServe(":8080", nil)
if err != nil {
log.Fatalf("服务启动失败：%v", err)
}
}
模板常用语法说明
除了基础的数据绑定，html/template还支持条件判断、循环遍历、自定义函数等常用语法，满足复杂的页面渲染需求。
条件判断语法
使用{{if 条件}}...{{else}}...{{end}}的结构实现条件渲染，下面的示例根据用户的登录状态显示不同的内容：
<body>
{{if .IsLogin}}
<p>欢迎回来，{{.Username}}</p>
<a href="/logout">退出登录</a>
{{else}}
<p>您还未登录</p>
<a href="/login">去登录</a>
{{end}}
</body>
循环遍历语法
使用{{range .集合}}...{{end}}的结构遍历数组、切片或者map，下面的示例渲染文章列表：
<body>
<ul>
{{range .ArticleList}}
<li>{{.Title}} - {{.Author}}</li>
{{else}}
<li>暂无文章</li>
{{end}}
</ul>
</body>
对应的Go数据结构定义如下：
type Article struct {
Title string
Author string
}
type PageData struct {
ArticleList []Article
}
自定义模板函数
如果内置的模板函数无法满足需求，可以通过自定义函数扩展模板能力，自定义函数需要在解析模板之前注册。下面的示例注册一个格式化时间的自定义函数：
package main
import (
"html/template"
"log"
"net/http"
"time"
)
// 自定义时间格式化函数
func formatTime(t time.Time) string {
return t.Format("2006年01月02日 15:04")
}
func indexHandler(w http.ResponseWriter, r *http.Request) {
// 创建模板对象并注册自定义函数
funcMap := template.FuncMap{
"formatTime": formatTime,
}
tpl := template.New("index.tmpl").Funcs(funcMap)
// 解析模板
tpl, err := tpl.ParseFiles("index.tmpl")
if err != nil {
log.Fatalf("解析模板失败：%v", err)
}
// 准备数据
data := map[string]interface{}{
"PublishTime": time.Now(),
}
// 执行渲染
err = tpl.Execute(w, data)
if err != nil {
log.Fatalf("渲染模板失败：%v", err)
}
}
func main() {
http.HandleFunc("/", indexHandler)
log.Println("服务启动在 :8080")
err := http.ListenAndServe(":8080", nil)
if err != nil {
log.Fatalf("服务启动失败：%v", err)
}
}
模板中使用自定义函数的方式为{{formatTime .PublishTime}}。
模板嵌套使用
在复杂的Web项目中，通常会把页面的公共部分（比如头部、尾部）抽成单独的模板，然后通过模板嵌套的方式复用。首先定义基础模板base.tmpl：
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>{{template "title" .}}</title>
</head>
<body>
<header>这是公共头部</header>
{{template "content" .}}
<footer>这是公共尾部</footer>
</body>
</html>
然后定义子模板index.tmpl，通过{{define "模板名"}}...{{end}}定义模板块，再嵌套基础模板：
{{define "title"}}首页{{end}}
{{define "content"}}
<h1>这是首页内容</h1>
<p>首页独有的内容区域</p>
{{end}}
{{template "base.tmpl" .}}
解析模板时需要同时解析基础模板和子模板：
tpl, err := template.ParseFiles("base.tmpl", "index.tmpl")
if err != nil {
log.Fatalf("解析模板失败：%v", err)
}
注意事项
- html/template会自动对插入的动态内容进行HTML转义，避免XSS攻击，如果需要输出不转义的HTML内容，可以使用template.HTML类型包装数据。
- 生产环境中不建议每次请求都解析模板，可以在程序启动时一次性解析所有模板，后续直接复用模板对象。
- 模板文件的路径需要注意相对路径的问题，建议统一使用绝对路径或者配置固定的模板目录。
Golang模板渲染Web模板引擎html_template修改时间：2026-06-26 23:45:50