在Golang的Web开发场景中，使用html/template标准库可以安全高效地实现HTML模板渲染，完成动态页面的生成，避免手动拼接HTML带来的安全风险和代码冗余问题。
html/template库的核心优势
html/template是Golang官方提供的模板处理库，和text/template语法类似，但内置了HTML转义机制，会自动对插入的动态内容进行转义，防止XSS攻击，非常适合用于生成HTML页面。它支持模板嵌套、条件判断、循环遍历等常用逻辑，能够满足大部分动态页面的渲染需求。
实现HTML模板渲染的完整步骤
1. 创建HTML模板文件
首先在项目目录下创建模板文件，比如index.html，模板中使用双大括号{{}}包裹动态内容占位符，示例如下：
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>{{.Title}}</title>
</head>
<body>
<h1>欢迎来到{{.SiteName}}</h1>
<p>当前用户：{{.Username}}</p>
<ul>
{{range .ArticleList}}
<li>{{.}}</li>
{{end}}
</ul>
</body>
</html>
2. 解析模板文件
在Golang代码中，使用template.ParseFiles方法解析模板文件，该方法会读取模板内容并返回模板对象，示例代码如下：
package main
import (
"html/template"
"log"
)
func main() {
// 解析单个模板文件
tpl, err := template.ParseFiles("index.html")
if err != nil {
log.Fatalf("模板解析失败：%v", err)
}
// 解析多个模板文件可以使用ParseGlob，比如template.ParseGlob("templates/*.html")
_ = tpl
}
3. 定义渲染数据
模板中使用的动态数据需要定义为结构体或者map，字段名需要和模板中的占位符对应，注意结构体字段需要首字母大写才能被模板访问：
// 定义模板数据结构体
type PageData struct {
Title string
SiteName string
Username string
ArticleList []string
}
// 初始化数据
data := PageData{
Title: "首页",
SiteName: "技术博客",
Username: "测试用户",
ArticleList: []string{"Golang基础教程", "HTML模板使用指南", "Web开发实战"},
}
4. 执行模板渲染
调用模板对象的Execute方法，传入输出流和数据即可完成渲染，如果是Web场景可以直接将响应写入器作为输出流：
package main
import (
"html/template"
"log"
"net/http"
)
type PageData struct {
Title string
SiteName string
Username string
ArticleList []string
}
func indexHandler(w http.ResponseWriter, r *http.Request) {
// 解析模板
tpl, err := template.ParseFiles("index.html")
if err != nil {
log.Printf("模板解析失败：%v", err)
http.Error(w, "页面加载失败", http.StatusInternalServerError)
return
}
// 准备渲染数据
data := PageData{
Title: "首页",
SiteName: "技术博客",
Username: "测试用户",
ArticleList: []string{"Golang基础教程", "HTML模板使用指南", "Web开发实战"},
}
// 设置响应头内容类型
w.Header().Set("Content-Type", "text/html; charset=utf-8")
// 执行渲染，将结果写入响应
err = tpl.Execute(w, data)
if err != nil {
log.Printf("模板渲染失败：%v", err)
http.Error(w, "页面渲染失败", http.StatusInternalServerError)
}
}
func main() {
http.HandleFunc("/", indexHandler)
log.Println("服务启动在 127.0.0.1:8080")
err := http.ListenAndServe("127.0.0.1:8080", nil)
if err != nil {
log.Fatalf("服务启动失败：%v", err)
}
}
模板常用语法说明
- 变量输出：使用
{{.FieldName}}输出对应数据，根数据用.表示 - 循环遍历：使用
{{range .List}}{{.}}{{end}}遍历切片或数组，内部用.表示当前元素 - 条件判断：使用
{{if .Condition}}内容{{else}}其他内容{{end}}实现条件分支 - 模板嵌套：使用
{{template "子模板名" .}}引入其他模板，子模板用{{define "子模板名"}}内容{{end}}定义
注意事项
html/template会自动对输出的内容进行HTML转义，比如用户输入的<script>会被转义为<script>，避免XSS攻击。如果需要输出不转义的HTML内容，可以使用template.HTML类型包装数据，但需要确保内容来源安全。
另外，模板解析操作比较消耗资源，实际开发中建议将模板解析放在程序初始化阶段，而不是每次请求时都解析，提升渲染性能。
Golanghtml_template动态页面模板渲染修改时间：2026-07-21 18:00:28