Golang如何使用html/template生成HTML模板-Golang-PHP中文网

Golang如何使用html/template生成HTML模板

P粉602998670

发布： 2025-11-12 21:00:03

原创

660人浏览过

Go语言中html/template包通过解析模板并渲染数据生成安全HTML。1. 使用template.New或template.Must解析字符串模板，自动转义特殊字符；2. 用template.ParseFiles加载外部HTML文件；3. 模板支持if、range等控制结构处理条件与循环；4. 字段类型设为template.HTML可避免内容被转义，输出原始HTML。

golang如何使用html/template生成html模板

在Go语言中，html/template 包用于安全地生成HTML内容，防止XSS攻击。它通过将数据与模板结合，动态输出HTML页面。下面介绍如何使用它来生成HTML模板。

1. 基本用法：定义模板并渲染数据

你可以使用 template.New 创建一个新模板，或直接使用 template.Must(template.Parse) 解析字符串模板。

注意：html/template 会自动转义HTML特殊字符，确保输出安全。

示例代码：

package main
<p>import (
"html/template"
"log"
"os"
)</p><p>func main() {
// 定义模板字符串
const tpl = <code> <h1>Hello, {{.Name}}</h1> <p>Your email: {{.Email}}</p><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/00968c3c2c15" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">go语言免费学习笔记（深入）</a>”；</p> </code></p><pre class="brush:php;toolbar:false;"><pre class="brush:php;toolbar:false;">// 创建并解析模板
t := template.Must(template.New("example").Parse(tpl))

// 定义数据
data := struct {
    Name  string
    Email string
}{
    Name:  "Alice",
    Email: "alice@example.com",
}

// 渲染到标准输出
if err := t.Execute(os.Stdout, data); err != nil {
    log.Fatal("执行模板出错:", err)
}

登录后复制

}

2. 加载外部HTML文件作为模板

实际项目中，模板通常保存在独立的HTML文件中。可以使用 template.ParseFiles 加载文件。

假设有一个文件 templates/profile.html：

<!DOCTYPE html>
<html>
<head><title>用户资料</title></head>
<body>
  <h1>欢迎, {{.Name}}!</h1>
  <p>你已登录邮箱: {{.Email}}</p>
</body>
</html>

登录后复制

Go代码加载该文件：

AiPPT模板广场

AiPPT模板广场-PPT模板-word文档模板-excel表格模板

147

查看详情

t, err := template.ParseFiles("templates/profile.html")
if err != nil {
    log.Fatal("解析模板失败:", err)
}
data := map[string]string{
    "Name":  "Bob",
    "Email": "bob@example.com",
}
t.Execute(os.Stdout, data)

登录后复制

3. 使用模板变量、条件和循环

模板支持控制结构如 if、range 等。

例如，展示用户列表：

{{if .Users}}
  <ul>
  {{range .Users}}
    <li>{{.Name}} - {{.Email}}</li>
  {{end}}
  </ul>
{{else}}
  <p>暂无用户</p>
{{end}}

登录后复制

对应的数据结构：

data := struct {
    Users []struct{ Name, Email string }
}{
    Users: []struct{ Name, Email string }{
        {"Alice", "a@example.com"},
        {"Bob", "b@example.com"},
    },
}

登录后复制

4. 避免HTML被转义的方法

默认情况下，所有输出都会被HTML转义。如果你需要输出原始HTML，字段类型应为 template.HTML。

示例：

data := struct {
    Content template.HTML
}{
    Content: template.HTML("<strong>这是一段加粗内容</strong>"),
}

登录后复制

此时模板中 {{.Content}} 会渲染为实际HTML标签，而不是转义文本。

基本上就这些。掌握 Parse、Execute、控制结构和安全输出，就能在Golang中灵活使用 html/template 生成HTML页面。

以上就是Golang如何使用html/template生成HTML模板的详细内容，更多请关注php中文网其它相关文章！