go模板渲染 | 豆包MarsCode AI刷题在 Web 开发中，模板引擎是不可或缺的工具之一，用于将静态页面与动态内

在 Web 开发中，模板引擎是不可或缺的工具之一，用于将静态页面与动态内容结合起来。Go 语言自带了强大的模板引擎 html/template 和 text/template，其中 html/template 主要用于生成安全的 HTML 内容。

什么是模板？

模板（Template）是一种通过占位符来插入动态数据的技术。在 Web 开发中，模板引擎能够根据业务逻辑生成 HTML，解决了手写 HTML 的繁琐和不灵活的问题。

Go 的模板功能具有以下特点：

安全性：html/template 会自动对 HTML 进行转义，防止 XSS 攻击。
强大功能：支持条件判断、循环、函数调用等。
易用性：语法简单，易于学习和使用。

在 Go 中，html/template 提供了功能丰富且安全的模板处理功能，尤其针对 HTML 内容进行了防范 XSS 的安全处理。

实战项目：构建一个简单博客

我们将构建一个小型博客系统，包含以下功能：

使用模板渲染 HTML 页面。
数据动态传递并展示。
实现页面的结构化。

1. 项目结构

首先，设计一个简单的博客页面，用于展示文章标题和内容。项目结构如下：

myblog/
|—— go.mod
├── main.go
├── templates/
│   ├── layout.html
│   ├── post.html

2. 模板文件

2.1 `layout.html`

layout.html 是主模板，主模板定义了页面的整体框架，包含头部、主内容区域和尾部：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>{{ .Title }}</title>
</head>
<body>
    <header>
        <h1>{{ .Header }}</h1>
    </header>
    <main>
        {{ template "content" . }}
    </main>
    <footer>
        <p>Powered by Go</p>
    </footer>
</body>
</html>

这里使用了 {{ . }} 来表示动态数据，并通过 {{ template "content" . }} 插入子模板内容。

2.2 `post.html`

post.html 是子模板，用于展示博客文章内容：

{{ define "content" }}
<article>
    <h2>{{ .Post.Title }}</h2>
    <p>{{ .Post.Body }}</p>
</article>
{{ end }}

在这里，我们使用 {{ define "content" }} 定义了子模板，并通过 {{ .Post.Title }} 等占位符填充动态数据。

3. 主程序代码

3.1 加载模板

在 main.go 中实现逻辑，包括模板加载、数据绑定和服务启动。

package main

import (
	"html/template"
	"net/http"
)

// 数据结构定义
type Post struct {
	Title string
	Body  string
}

type PageData struct {
	Title  string
	Header string
	Post   Post
}

func main() {
	// 加载模板
	tmpl := template.Must(template.ParseFiles("templates/layout.html", "templates/post.html"))

	// 定义路由
	http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
		// 构造数据
		data := PageData{
			Title:  "我的博客",
			Header: "欢迎来到我的博客",
			Post: Post{
				Title: "Go 模板教程",
				Body:  "这是一个使用 Go 模板引擎渲染 HTML 的简单示例。",
			},
		}

		// 渲染模板
		err := tmpl.Execute(w, data)
		if err != nil {
			http.Error(w, err.Error(), http.StatusInternalServerError)
		}
	})

	// 启动服务器
	http.ListenAndServe(":8080", nil)
}

3.2 代码详解

模板加载：

tmpl := template.Must(template.ParseFiles("templates/layout.html", "templates/post.html"))

使用 template.ParseFiles 加载多个模板文件，并用 template.Must 进行错误处理。

数据结构：定义了 Post 和 PageData 两个结构体，分别表示文章和页面数据。
渲染模板：

err := tmpl.Execute(w, data)

使用 Execute 方法将数据渲染到模板中，结果写入 HTTP 响应。

错误处理：如果模板渲染失败，返回 500 错误。
启动服务器：

http.ListenAndServe(":8080", nil)

在本地启动一个 HTTP 服务，监听 8080 端口。

4. 启动程序

在myblog目录下运行 main.go：

go run .

打开浏览器访问 http://localhost:8080,即可得到如下图的页面。

模板语法扩展

Go 的模板语法非常灵活，支持以下功能：

条件判断

通过 if 实现条件渲染：

{{ if .IsLoggedIn }}
<p>欢迎回来，{{ .UserName }}</p>
{{ else }}
<p>请登录。</p>
{{ end }}

循环

通过 range 遍历数组或切片：

<ul>
    {{ range .Posts }}
    <li>{{ .Title }}</li>
    {{ end }}
</ul>

管道操作

可以通过管道调用函数处理数据：

<p>{{ .Date | dateFormat }}</p>

优化与扩展

抽离公共部分：将头部和尾部分离为独立模板文件，通过嵌套模板实现复用。
添加更多动态数据：扩展 PageData 和 Post 结构，支持多篇文章的展示。
引入 CSS/JS：在模板中引入静态资源文件，提升页面的美观和交互性。
模板函数：自定义函数用于数据格式化。例如，日期格式化或字符串处理。

go模板渲染 | 豆包MarsCode AI刷题