当前位置：首页 > 文章列表 > Golang > Go教程 > Golang模板库详解：HTML与文本应用指南

Golang模板库详解：HTML与文本应用指南

2025-11-26 18:03:36 0浏览收藏

本文深入解析 Golang 的 template 库，重点讲解 `text/template` 和 `html/template` 的应用。`text/template` 适用于生成配置文件、日志等通用文本，通过定义模板、准备数据、解析执行即可实现文本输出。而 `html/template` 专为 HTML 设计，具备自动转义机制，有效防止 XSS 攻击，更适合网页内容渲染。文章对比了两者在 API、用途和安全性上的差异，并详细阐述了各自的应用场景，例如，`text/template` 常用于命令行输出和邮件发送，`html/template` 则用于 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 = `<p>Hello, {{.Name}}</p>`

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

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