Go语言的html/template包是构建安全、动态网页的核心工具，它通过自动HTML转义有效防御XSS攻击，支持模板解析、嵌套复用、自定义函数、条件控制与循环遍历等丰富功能，并能无缝集成HTTP服务；本文系统讲解了从基础数据渲染、外部文件加载、错误简化处理，到结构体字段导出要求、原始HTML输出技巧及生产环境最佳实践，助你用纯Go快速搭建可信赖的服务器端渲染应用。

在 Go 语言中，html/template 包用于安全地渲染 HTML 模板，防止 XSS 攻击，其核心用法包括定义模板、解析文件、嵌套复用、自定义函数及结合 HTTP 服务输出动态内容，必须使用导出字段并注意自动转义机制，最终通过 Execute 或 ExecuteTemplate 方法将数据注入模板并完整输出 HTML 内容。

在 Go 语言中，html/template 包是处理 HTML 模板渲染的核心工具。它不仅安全（自动转义防止 XSS 攻击），而且功能强大，适合构建动态网页内容。下面详细介绍如何使用 template 包来渲染 HTML 页面。

一、基本用法：定义模板并渲染数据

html/template 的核心是将结构化数据注入到 HTML 模板中，生成最终的 HTML 输出。

package main

import (
    "html/template"
    "log"
    "os"
)

type User struct {
    Name  string
    Email string
}

func main() {
    // 定义模板字符串
    const tmpl = `
Hello, {{.Name}}!
Email: {{.Email}}
`

    // 解析模板
    t, err := template.New("user").Parse(tmpl)
    if err != nil {
        log.Fatal(err)
    }

    // 准备数据
    user := User{Name: "Alice", Email: "alice@example.com"}

    // 渲染模板到标准输出
    err = t.Execute(os.Stdout, user)
    if err != nil {
        log.Fatal(err)
    }
}

输出结果：

Hello, Alice!
Email: alice@example.com

注意：使用 html/template 而不是 text/template，因为前者会对输出自动进行 HTML 转义，防止 XSS。

二、加载外部 HTML 文件模板

通常模板会写在 .html 文件中，便于维护。

假设有一个 templates/index.html：

    
Welcome, {{.Name}}!
    
Your email is: {{.Email}}

Go 代码加载并渲染：

t, err := template.ParseFiles("templates/index.html")
if err != nil {
    log.Fatal(err)
}
user := User{Name: "Bob", Email: "bob@example.com"}
t.Execute(os.Stdout, user)

也可以一次加载多个模板文件：

template.ParseFiles("header.html", "footer.html", "index.html")

三、使用 template.Must 简化错误处理

template.Must 是一个辅助函数，用于包装 Parse 或 ParseFiles，如果解析失败会直接 panic。

t := template.Must(template.ParseFiles("templates/index.html"))
t.Execute(os.Stdout, user)

适用于开发阶段或确定模板文件一定存在的情况。

四、模板语法详解

1. 数据引用

• {{.}}：表示当前上下文的数据
• {{.FieldName}}：访问结构体字段（必须是导出字段，首字母大写）
• {{.Field.Nested}}：支持嵌套结构

type Profile struct {
    User  User
    Age   int
    Hobbies []string
}

模板中：

Age: {{.Age}}
Hobbies: {{range .Hobbies}}{{.}}{{end}}

2. 控制结构

• if 判断：

  {{if .Email}}
    
  Email: {{.Email}}
  {{else}}
    
  No email provided.
  {{end}}

• range 遍历：

  
  {{range .Hobbies}}
    
  {{.}}
  {{end}}
  

• with：切换上下文

  {{with .User}}
    
  {{.Name}}
  {{end}}

3. 变量定义（以 $ 开头）

{{ $email := .Email }}
Contact: {{$email}}

可以在 range 中避免变量覆盖时使用。

五、模板嵌套与复用：define 和 template

可以定义多个命名模板，并在主模板中嵌套使用。

例如 layout.html：

{{define "header"}}

{{end}}

{{define "footer"}}

{{end}}

page.html：

{{template "header" .}}
{{.Content}}
{{template "footer" .}}

Go 代码：

t := template.Must(template.ParseFiles("layout.html", "page.html"))
data := map[string]string{
    "Title":   "My Page",
    "Content": "Hello World",
}
t.ExecuteTemplate(os.Stdout, "page.html", data)

ExecuteTemplate 可以指定执行某个命名模板。

六、自定义函数：FuncMap

你可以向模板中注入自定义函数，比如格式化时间、转大写等。

funcMap := template.FuncMap{
    "upper": strings.ToUpper,
    "formatDate": func(t time.Time) string {
        return t.Format("2006-01-02")
    },
}

t := template.New("demo").Funcs(funcMap)
t, err := t.Parse("Name: {{.Name | upper}}")

使用管道 | 调用函数。

七、常见陷阱与注意事项

• 字段必须可导出：模板只能访问结构体中首字母大写的字段。
• 自动转义：HTML、JS、URL 等内容会被自动转义。若要输出原始 HTML，使用 template.HTML 类型：

  type Data struct {
      Content template.HTML
  }
  data := Data{Content: template.HTML("Bold text")}

  否则 会被转义成 <b>。

• 模板缓存：生产环境建议预解析模板，避免每次请求都解析。
• 错误处理：模板执行错误（如字段不存在）会返回错误，需检查 Execute 返回值。

八、结合 HTTP 服务使用

在 Web 应用中，通常配合 net/http 使用：

http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
    t := template.Must(template.ParseFiles("templates/index.html"))
    user := User{Name: "Alice", Email: "alice@example.com"}
    t.Execute(w, user)
})
http.ListenAndServe(":8080", nil)

基本上就这些核心用法。掌握 html/template 包后，你可以在不引入前端框架的情况下，用 Go 构建简单的动态网页应用。关键是理解数据传递、模板语法和安全转义机制。

以上就是《Golangtemplate包使用详解教程》的详细内容，更多关于的资料请关注golang学习网公众号！