本文介绍了如何使用 Go 标准库 html/template 实现类似 Jinja 或 Django 模板引擎的嵌套模板功能。核心思想是将多个模板文件解析为一个模板集合，并通过 template 指令在不同的模板之间进行引用和组合。通过自定义模板集合的映射，可以实现灵活的模板继承和复用。
Go 语言的标准库 html/template 提供了强大的模板渲染功能。虽然它不像 Jinja 或 Django 模板引擎那样直接支持嵌套模板，但我们可以通过一些技巧来实现类似的功能。关键在于理解 html.Template 本质上是一个模板文件的集合，并且可以通过 template 指令在这些模板之间进行引用。
实现原理
实现嵌套模板的核心思路是：
- 定义基础模板（base template）： 基础模板定义了页面的整体结构，并使用 {{template "block_name" .}} 标记出可以被子模板填充的区域（block）。
- 定义子模板： 子模板定义了特定页面的内容，并使用 {{define "block_name"}}...{{end}} 块来覆盖基础模板中对应的 block。
- 解析模板集合： 将基础模板和子模板解析为一个 html.Template 集合。
- 执行模板： 通过执行指定的模板，并传入数据，即可生成最终的 HTML 页面。
示例代码
以下示例演示了如何使用 html/template 实现嵌套模板。
首先，创建三个文件：base.html、index.html 和 other.html。
base.html:
{{define "base"}}
{{template "title" .}}
{{template "header" .}}
{{template "content" .}}
{{end}}index.html:
{{define "title"}}Index Page{{end}}
{{define "header"}}Welcome to the Index Page
{{end}}
{{define "content"}}This is the content of the index page.
{{end}}
{{define "footer"}}Copyright 2023
YIXUNCMS中秋专版2.0.4
系统介绍：YIXUNCMS中专专版是易迅软件工作室在中秋节来临之即推出的专题模板建站系统，使用增强版后台管控系统，板板设计符合节日特点。易迅软件工作室恭祝全国人民中秋快乐。特别提示：由于网站页面的不同设计，部分后台功能未在前端进行体现。系统特点：1、采用目前流行的PHP语言编写，底层采用超轻量级框架作为系统支撑；2、页面布局使用DIV+CSS技术，遵循WEB标准，及大提高页面的浏览速度；3、使用应
下载
{{end}}other.html:
{{define "title"}}Other Page{{end}}
{{define "header"}}Welcome to the Other Page
{{end}}
{{define "content"}}This is the content of the other page.
{{end}}
{{define "footer"}}Copyright 2023
{{end}}然后，编写 Go 代码来解析和执行模板：
package main
import (
"html/template"
"log"
"os"
)
func main() {
tmpl := make(map[string]*template.Template)
tmpl["index.html"] = template.Must(template.ParseFiles("index.html", "base.html"))
tmpl["other.html"] = template.Must(template.ParseFiles("other.html", "base.html"))
data := map[string]interface{}{
"Name": "World",
}
err := tmpl["index.html"].ExecuteTemplate(os.Stdout, "base", data)
if err != nil {
log.Fatal(err)
}
err = tmpl["other.html"].ExecuteTemplate(os.Stdout, "base", data)
if err != nil {
log.Fatal(err)
}
}在这个例子中，我们创建了一个 tmpl map，其中键是模板文件名，值是解析后的 template.Template 对象。 template.ParseFiles 函数将 index.html 和 base.html 解析为一个模板集合，并将结果存储在 tmpl["index.html"] 中。 然后，我们使用 ExecuteTemplate 函数执行名为 "base" 的模板，并将数据 data 传递给模板。
运行这段代码，将会分别输出基于 index.html 和 other.html 的渲染结果，它们都继承了 base.html 的结构。
注意事项
- 模板命名： 确保在基础模板中使用有意义的 block 名称，并在子模板中正确地覆盖这些 block。
- 错误处理： template.Must 函数在解析模板失败时会 panic。在生产环境中，应该使用更健壮的错误处理机制。
- 数据传递： 传递给 ExecuteTemplate 函数的数据可以是任何类型，模板可以使用 . 访问当前上下文的数据。
- 模板缓存： 为了提高性能，可以将解析后的模板缓存起来，避免每次请求都重新解析模板。
- 安全性： html/template 会自动进行上下文相关的转义，以防止 XSS 攻击。
总结
虽然 html/template 没有直接提供类似 Jinja 或 Django 的嵌套模板功能，但通过将多个模板文件解析为一个模板集合，并使用 template 指令进行引用，我们可以实现类似的功能。 这种方法提供了灵活的模板继承和复用机制，可以有效地组织和管理模板代码。 通过合理的组织和使用，可以构建出复杂且易于维护的 Go Web 应用。
