Golang模板渲染HTML教程详解

哈喽！今天心血来潮给大家带来了《Golang模板引擎渲染HTML教程》，想必大家应该对Golang都不陌生吧，那么阅读本文就都不会很困难，以下内容主要涉及到，若是你正在学习Golang，千万别错过这篇文章~希望能帮助到你！

html/template 默认对变量输出做HTML转义防XSS，text/template不转义；html/template校验标签闭合，后者不校验；渲染HTML必须用前者，并设Content-Type。

Go 的 html/template 和 text/template 有什么区别？

直接用 html/template，别选 text/template 渲染 HTML。前者默认对变量输出做 HTML 转义（比如把 < 变成 <），防止 XSS；后者不转义，容易出安全问题。

除非你明确要输出纯文本（如生成配置文件、邮件正文），否则一律用 html/template。

• html/template 的 {{.Name}} 会自动转义 、>、&、"、'
• 若需原样插入 HTML（比如后端拼好的 safeHTML 字段），必须用 {{.Content | safeHTML}}，且该字段类型得是 template.HTML
• 加载模板时，html/template 会校验标签闭合，text/template 不校验 —— 这意味着用错包可能让页面渲染出错但无提示

怎么加载并渲染一个 HTML 模板文件？

典型流程：解析文件 → 构建数据 → 执行写入 http.ResponseWriter 或 bytes.Buffer。

注意路径是相对于 os.Getwd()（运行目录），不是源码目录；推荐用 embed（Go 1.16+）避免部署时漏模板文件。

package main

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

//go:embed templates/*.html
var templatesFS embed.FS

func handler(w http.ResponseWriter, r *http.Request) {
    t := template.Must(template.ParseFS(templatesFS, "templates/*.html"))
    data := struct{ Title string }{Title: "首页"}
    w.Header().Set("Content-Type", "text/html; charset=utf-8")
    t.Execute(w, data)
}

• template.ParseFiles("index.html") 简单但易因路径出错；ParseFS 更健壮
• template.Must() 在解析失败时 panic，适合启动期加载；线上服务建议自己捕获 error
• 务必手动设置 Content-Type，否则浏览器可能误判编码，中文变乱码

如何在模板里安全插入动态 HTML？

不能直接写 {{.RawHTML}}，那会被转义成字符串字面量。必须显式标记为“可信”：

type PageData struct {
    Title   string
    Content template.HTML // 类型必须是 template.HTML
}

func handler(w http.ResponseWriter, r *http.Request) {
    data := PageData{
        Title:   "公告",
        Content: template.HTML(`<p>欢迎</p><strong>加粗</strong>`),
    }
    t := template.Must(template.New("").Parse(`<h1>{{.Title}}</h1>{{.Content}}`))
    t.Execute(w, data)
}

• 字段类型必须是 template.HTML，不是 string
• 不要在模板里用 {{.Content | printf "%s"}} 之类绕过 —— 不生效，且破坏安全模型
• 如果 HTML 来自用户输入，千万别转成 template.HTML！应先用 bluemonday 等库净化

常见报错和调试技巧

模板执行失败通常静默返回空内容或 500，很难定位。关键错误类型：

• template: xxx:xxx: unexpected EOF：模板文件末尾缺 {{end}} 或括号不匹配
• template: xxx:xxx: nil pointer evaluating interface {}.Field：传了 nil 结构体或字段未导出（首字母小写）
• 页面显示 {{.Name}} 原样字符串：没调 Execute，或 Execute 返回 error 但被忽略
• 中文乱码：响应头没设 Content-Type: text/html; charset=utf-8，或模板文件本身不是 UTF-8 编码

调试建议：先用 bytes.Buffer 替代 http.ResponseWriter，打印出错时的完整 error 和输出内容。

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