Go语言通过html/template包实现安全的动态页面渲染,支持变量、条件、循环和自定义函数。1. 使用{{}}语法嵌入逻辑,结合结构体渲染数据;2. 通过{{if}}{{range}}处理条件与遍历;3. 利用ParseGlob加载模板文件,通过block实现布局复用;4. 注册FuncMap扩展函数如格式化时间。掌握这些可构建清晰易维护的Web页面系统。

在Go语言中,使用html/template包可以轻松实现动态页面的渲染。它不仅安全(自动转义HTML),还支持变量、条件判断、循环、函数调用等特性,非常适合构建简单的Web应用或服务端渲染页面。
1. 基本模板语法与渲染流程
Go模板通过双花括号{{}}嵌入逻辑,支持变量输出、控制结构和函数调用。
例如,定义一个简单的HTML模板:
用户信息 欢迎,{{.Name}}!
年龄:{{.Age}}
立即学习“go语言免费学习笔记(深入)”;
对应的结构体和渲染代码:
package main
import (
"html/template"
"net/http"
)
type User struct {
Name string
Age int
}
func handler(w http.ResponseWriter, r *http.Request) {
user := User{Name: "Alice", Age: 25}
tmpl := template.Must(template.New("user").ParseGlob("templates/*.html"))
tmpl.Execute(w, user)
}
func main() {
http.HandleFunc("/", handler)
http.ListenAndServe(":8080", nil)
}
2. 条件判断与循环遍历
模板支持{{if}}、{{range}}等控制结构,用于处理复杂数据。
比如展示用户列表并根据是否在线显示不同状态:
{{range .Users}}
{{.Name}}
{{if .Online}}
在线
{{else}}
离线
{{end}}
{{end}}
对应的数据结构示例:
data := struct {
Users []struct{
Name string
Online bool
}
}{
Users: []struct{
Name string
Online bool
}{
{"Bob", true},
{"Charlie", false},
},
}
3. 使用模板文件与布局复用
实际项目中通常将模板保存为文件,便于维护。Go支持template.ParseFiles和template.ParseGlob加载多个文件。
常见做法是拆分头部、侧边栏、底部等公共部分:
layout.html
{{block "title" .}}默认标题{{end}} {{block "content" .}}
index.html
{{define "title"}}首页{{end}}
{{define "content"}}
这是主页内容
{{end}}
加载并执行:
tmpl := template.Must(template.ParseGlob("views/*.html"))
tmpl.ExecuteTemplate(w, "layout", nil)
4. 自定义模板函数
通过template.FuncMap注册自定义函数,扩展模板能力。
例如添加一个格式化时间的函数:
funcMap := template.FuncMap{
"formatDate": func(t time.Time) string {
return t.Format("2006-01-02")
},
}
tmpl := template.New("demo").Funcs(funcMap)
template.Must(tmpl.ParseFiles("views/demo.html"))
模板中使用:
发布于:{{.PublishTime | formatDate}}
基本上就这些。掌握变量渲染、控制结构、模板复用和自定义函数后,就能用Go构建出结构清晰、可维护的动态页面系统。不复杂但容易忽略的是转义机制和block块的作用域,建议多测试边界情况。










