Go 模板引擎中安全地包含 HTML 内容-Golang-PHP中文网

Go 模板引擎中安全地包含 HTML 内容

心靈之曲

发布： 2025-10-24 09:38:14

原创

641人浏览过

go 模板引擎中安全地包含 html 内容

本文介绍了如何在 Go 模板引擎中安全地包含 HTML 内容。通过将 `[]byte` 或 `string` 类型转换为 `template.HTML` 类型，并修改 `Page` 结构体定义，可以避免 HTML 内容被转义，从而在模板中正确渲染 HTML。文章提供了详细的代码示例和步骤，帮助开发者理解和应用该方法。

在使用 Go 的 html/template 包进行 Web 开发时，经常需要在模板中插入 HTML 内容。默认情况下，模板引擎会对插入的字符串进行转义，以防止跨站脚本攻击（XSS）。但有时我们希望直接渲染 HTML 内容，而不是进行转义。本文将介绍如何在 Go 模板引擎中安全地包含 HTML 内容。

核心思路：使用 template.HTML 类型

html/template 包提供了一个 template.HTML 类型，用于表示已知安全的 HTML 内容。当模板引擎遇到 template.HTML 类型的值时，不会对其进行转义，而是直接输出。

立即学习“前端免费学习笔记（深入）”；

步骤一：转换数据类型

首先，需要将需要渲染的 HTML 内容转换为 template.HTML 类型。假设你的 HTML 内容存储在 string 或 []byte 类型的变量 s 中，可以使用以下代码进行转换：

import "html/template"

// 如果 s 是 string 类型
htmlContent := template.HTML(s)

// 如果 s 是 []byte 类型
htmlContent := template.HTML(string(s))

登录后复制

步骤二：修改数据结构

如果你的 HTML 内容存储在结构体中，例如：

启科网络PHP商城系统

启科网络商城系统由启科网络技术开发团队完全自主开发，使用国内最流行高效的PHP程序语言，并用小巧的MySql作为数据库服务器，并且使用Smarty引擎来分离网站程序与前端设计代码，让建立的网站可以自由制作个性化的页面。系统使用标签作为数据调用格式，网站前台开发人员只要简单学习系统标签功能和使用方法，将标签设置在制作的HTML模板中进行对网站数据、内容、信息等的调用，即可建设出美观、个性的网站。

查看详情

type Page struct {
    Title string
    Body  []byte
}

登录后复制

你需要将 Body 字段的类型修改为 template.HTML：

type Page struct {
    Title string
    Body  template.HTML
}

登录后复制

这样，在赋值时就可以直接将 HTML 内容赋值给 Body 字段：

page := Page{
    Title: "My Page",
    Body:  template.HTML("<h1>This is a test</h1>"),
}

登录后复制

步骤三：在模板中使用

在模板中，直接使用 {{.Body}} 即可，模板引擎不会对 Body 的值进行转义：

<h1>{{.Title}}</h1>
<p>[<a href="/edit/{{.Title}}">edit</a>]</p>
<div>{{.Body}}</div>

登录后复制

完整示例

package main

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

type Page struct {
    Title string
    Body  template.HTML
}

func viewHandler(w http.ResponseWriter, r *http.Request) {
    page := Page{
        Title: "My Page",
        Body:  template.HTML("<h1>This is a test</h1><p>This is some content.</p>"),
    }

    tmpl, err := template.New("view").Parse(`
        <h1>{{.Title}}</h1>
        <div>{{.Body}}</div>
    `)
    if err != nil {
        http.Error(w, err.Error(), http.StatusInternalServerError)
        return
    }

    err = tmpl.Execute(w, page)
    if err != nil {
        http.Error(w, err.Error(), http.StatusInternalServerError)
        return
    }
}

func main() {
    http.HandleFunc("/", viewHandler)
    fmt.Println("Server listening on port 8080")
    http.ListenAndServe(":8080", nil)
}

登录后复制

注意事项