本文介绍了如何使用 Go 标准库 html/template 实现模板嵌套，类似于 Python 的 Jinja 或 Django 模板引擎的功能。通过将模板文件组织成模板集合，并利用 template.Execute 方法，可以实现模板的继承和块的填充，从而构建灵活可复用的模板结构。
Go 的 html/template 包虽然没有直接提供类似 Jinja 或 Django 模板引擎的继承功能，但通过合理地组织模板文件，可以实现类似的效果。核心思想是将多个模板文件组合成一个模板集合，然后通过执行指定的模板块来实现模板的嵌套和继承。
模板集合的概念
一个 html.Template 实际上是一个模板文件的集合。当执行集合中某个定义的块时，它可以访问集合中所有其他定义的块。 这使得我们可以定义一个基础模板，并在其他模板中覆盖或填充基础模板中的特定区域。
示例：使用基础模板和子模板
假设我们有三个模板文件：base.html（基础模板）、index.html（首页模板）和 other.html（其他页面模板）。index.html 和 other.html 都继承自 base.html。
base.html:
{{define "base"}}
<!DOCTYPE html>
<html>
<head>
{{template "head" .}}
</head>
<body>
{{template "body" .}}
</body>
</html>
{{end}}index.html:
{{define "head"}}
<title>Index Page</title>
{{end}}
{{define "body"}}
<h1>Welcome to the Index Page!</h1>
{{end}}other.html:
{{define "head"}}
<title>Other Page</title>
{{end}}
{{define "body"}}
<h1>This is the Other Page.</h1>
{{end}}代码实现
下面的 Go 代码演示了如何解析这些模板文件，并将它们存储在一个 map 中：
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{}{
"Title": "My Website",
"Content": "Some dynamic content here.",
}
// 执行模板，并将结果写入标准输出
err := tmpl["index.html"].ExecuteTemplate(os.Stdout, "base", data)
if err != nil {
log.Fatalf("执行 index.html 模板失败: %v", err)
}
println("\n==============================\n")
err = tmpl["other.html"].ExecuteTemplate(os.Stdout, "base", data)
if err != nil {
log.Fatalf("执行 other.html 模板失败: %v", err)
}
}代码解释:
- template.ParseFiles("index.html", "base.html"): 这行代码解析了 index.html 和 base.html 两个文件，并将它们组合成一个模板集合。 重要的是，base.html 必须在 index.html 之后解析，这样 index.html 才能覆盖 base.html 中定义的块。
- template.Must(...): template.Must 函数用于包装 template.ParseFiles，如果解析过程中发生错误，它会 panic，从而确保程序在模板解析失败时立即停止。
- tmpl["index.html"].ExecuteTemplate(os.Stdout, "base", data): 这行代码执行名为 "base" 的模板（在 base.html 中定义），并将结果写入 os.Stdout。 data 是一个 map，包含了传递给模板的数据。注意这里使用的是ExecuteTemplate而不是Execute，需要指定要执行的模板名称。
运行结果:
运行上述代码，将会分别输出渲染后的 index.html 和 other.html 内容。 index.html 将会使用 "Index Page" 作为标题，而 other.html 将会使用 "Other Page" 作为标题。 它们都继承了 base.html 的基本结构。
自动生成模板映射
如果模板文件数量很多，手动创建 tmpl 映射会很繁琐。 可以通过一些技巧（例如，使用一致的模板文件命名约定）来自动生成 tmpl 映射。 例如，可以遍历目录中的所有 .html 文件，并根据文件名构建模板映射。
注意事项
- 模板解析顺序: 模板解析的顺序很重要。 基础模板应该在子模板之后解析，以便子模板可以覆盖基础模板中的块。
- 错误处理: 在解析和执行模板时，应该始终进行错误处理，以避免程序崩溃。
- Context-Aware Escaping: html/template 提供了上下文相关的转义，可以有效地防止 XSS 攻击。
总结
通过使用 Go 标准库 html/template 和一些技巧，我们可以实现模板嵌套和继承，从而构建灵活可复用的模板结构。 这种方法虽然不如 Jinja 或 Django 模板引擎那样直接，但它提供了足够的灵活性，并且可以充分利用 Go 语言的强大功能。 关键在于理解模板集合的概念，并正确地解析和执行模板。
