首页 > Golang > Go教程

Golang模板库使用教程：HTML文本模板详解

时间：2025-07-10 17:28:26 164浏览收藏

本文深入解析 Golang 标准库中的 `template` 模板库，重点区分 `text/template` 和 `html/template` 的应用场景与安全特性。`text/template` 适用于生成配置文件、日志等通用文本输出，通过定义模板、准备数据并执行填充，实现灵活的文本格式化。而 `html/template` 专为 HTML 设计，具备自动 HTML 转义功能，有效防止 XSS 攻击，适用于 Web 页面渲染和邮件 HTML 内容构建。文章还探讨了模板使用的常见问题，如字段导出、嵌套结构访问、控制语句使用以及模板继承与组合，助你掌握 Golang 模板库的核心要点，提升服务端内容生成的效率与安全性。选择合适的模板类型，可以轻松应对各种静态内容生成的场景。

Golang 的 template 库分为 text/template 和 html/template，前者用于通用文本模板，后者专为 HTML 设计并具备安全防护机制。1. 使用 text/template 时，通过定义模板、准备数据结构、解析并执行填充来生成文本输出，适用于配置文件、日志格式等场景；2. html/template 会自动进行 HTML 转义，防止 XSS 攻击，并根据上下文选择合适的转义方式，适合网页内容渲染；3. 两者 API 类似，但适用场景不同：text/template 常用于生成配置文件、命令行输出等非 HTML 文本，html/template 则用于 Web 页面、邮件 HTML 内容等涉及浏览器展示的场景；4. 使用过程中需注意字段必须首字母大写才可被访问，支持嵌套结构和控制语句，但建议避免复杂逻辑，并可通过 define 和 block 实现模板继承与组合。

Golang的template库如何实现文本模板解析HTML模板与文本模板的应用场景

Golang 的 template 库是标准库中非常实用的一个工具，可以用来生成文本输出，比如 HTML 页面、配置文件、邮件内容等。它分为两个包：text/template 和 html/template，前者用于通用文本模板，后者专为 HTML 设计，做了安全防护。

如果你只是想做简单的文本替换，或者动态生成配置文件之类的内容，用 text/template 就足够了；而如果是在网页开发中渲染 HTML 页面，则推荐使用 html/template，因为它能自动处理 HTML 转义，防止 XSS 攻击。

1. 如何使用 `text/template` 实现文本模板

text/template 是 Go 中最基础的模板引擎，适用于各种文本格式的生成，比如日志格式、配置文件、命令行输出等。

基本步骤如下：

定义模板字符串或从文件加载
准备数据结构（struct 或 map）
解析模板并执行填充

举个例子，假设你想生成一段用户信息文本：

package main

import (
    "os"
    "text/template"
)

type User struct {
    Name string
    Age  int
}

func main() {
    const userTpl = "Name: {{.Name}}\nAge: {{.Age}}\n"

    t := template.Must(template.New("user").Parse(userTpl))

    user := User{Name: "Alice", Age: 30}
    _ = t.Execute(os.Stdout, user)
}

输出结果就是：

Name: Alice
Age: 30

这个过程很直接，核心在于模板语法和传入的数据结构是否匹配。

2. `html/template` 与 `text/template` 的区别

虽然两者 API 类似，但它们的用途和安全性设计不同。

HTML 转义机制：html/template 在输出时会自动对变量进行 HTML 转义，防止 XSS 漏洞。
上下文感知：它可以根据当前 HTML 上下文（如标签属性、JS 字符串等）自动选择合适的转义方式。
禁止执行任意函数：为了安全，html/template 对模板中调用函数有更多限制。

例如，在 HTML 模板中插入一个用户名：

package main

import (
    "html/template"
    "os"
)

func main() {
    const htmlTpl = `Hello, {{.Name}}`

    t := template.Must(template.New("page").Parse(htmlTpl))
    data := struct{ Name string }{"Alice"}
    _ = t.Execute(os.Stdout, data)
}

输出结果不会显示加粗的 “Alice”，而是原样显示 HTML 标签，并被自动转义成安全字符：