首页 > Golang > Go教程

Golang模板渲染教程与使用详解

时间：2025-12-02 22:31:05 104浏览收藏

本篇文章给大家分享《Golang模板渲染教程及使用方法》，覆盖了Golang的常见基础知识，其实一个语言的全部知识点一篇文章是不可能说完的，但希望通过这些问题，让读者对自己的掌握程度有一定的认识(B 数)，从而弥补自己的不足，更好的掌握它。

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

Golang如何使用模板渲染动态页面_Golang 模板渲染使用指南

在Go语言中，使用html/template包可以轻松实现动态页面的渲染。它不仅安全（自动转义HTML），还支持变量、条件判断、循环、函数调用等特性，非常适合构建简单的Web应用或服务端渲染页面。

1. 基本模板语法与渲染流程

Go模板通过双花括号{{}}嵌入逻辑，支持变量输出、控制结构和函数调用。

例如，定义一个简单的HTML模板：

<!DOCTYPE html>
<html>
<head><title>用户信息</title></head>
<body>
  <h1>欢迎，{{.Name}}！</h1>
  <p>年龄：{{.Age}}</p>
</body>
</html>

对应的结构体和渲染代码：

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}}
  <div class="user">
    <span>{{.Name}}</span>
    {{if .Online}}
      <span style="color:green;">在线</span>
    {{else}}
      <span style="color:gray;">离线</span>
    {{end}}
  </div>
{{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

<!DOCTYPE html>
<html>
<head><title>{{block "title" .}}默认标题{{end}}</title></head>
<body>
  {{block "content" .}}</body>
</html>

index.html

{{define "title"}}首页{{end}}
{{define "content"}}
  <h1>这是主页内容</h1>
{{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块的作用域，建议多测试边界情况。

本篇关于《Golang模板渲染教程与使用详解》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于Golang的相关知识，请关注golang学习网公众号！

golang 自定义函数模板渲染 html/template 模板语法