本文介绍了如何使用 Go 语言标准库 html/template 实现类似 Jinja 或 Django 模板的嵌套功能。通过将模板文件组织成模板集合，并利用 template.Execute 方法执行特定块，可以实现模板继承和内容填充，从而构建灵活可复用的模板结构。
Go 语言的 html/template 包本身并不直接支持像 Jinja 或 Django 那样的模板继承机制。然而，通过巧妙地组织模板文件和利用 template.Execute 方法，我们可以模拟出类似的效果。html.Template 实际上可以看作是一组模板文件的集合。当执行这个集合中的某个已定义的块时，它可以访问集合中所有其他的块。
实现原理
核心思想是将一组相关的模板文件（例如，一个基础模板和多个继承自该基础模板的子模板）解析到同一个 template.Template 实例中。然后，通过 Execute 方法执行基础模板中定义的特定块，这些块会调用其他模板中定义的块，从而实现模板的嵌套和继承。
示例代码
以下示例演示了如何使用 html/template 实现模板嵌套，其中包含一个基础模板 base.html 和两个子模板 index.html 和 other.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 代码:
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]string{
"Title": "My Website",
}
// 执行模板
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)
}
}在这个例子中，base.html 定义了页面的基本结构，并使用 {{template "head" .}} 和 {{template "body" .}} 定义了两个块，用于填充头部和主体内容。index.html 和 other.html 分别定义了这两个块的具体内容。Go 代码首先将这些模板文件解析到 tmpl map 中，然后使用 ExecuteTemplate 方法执行 base 模板，并将数据传递给模板。
注意事项
- 模板解析顺序: 在 template.ParseFiles 函数中，模板文件的解析顺序很重要。基础模板应该在子模板之后解析，这样子模板才能正确地覆盖基础模板中的块。
- 错误处理: template.Must 函数用于简化错误处理，但在生产环境中，应该使用更完善的错误处理机制。
- 模板命名: 为了方便管理和自动生成模板映射，可以采用一致的模板命名规范。
- 数据传递: 传递给 Execute 或 ExecuteTemplate 方法的数据可以是任意类型，模板中可以使用 . 来访问数据成员。
总结
虽然 html/template 包没有提供直接的模板继承机制，但通过将模板文件组织成模板集合，并利用 ExecuteTemplate 方法，可以实现类似的功能。这种方法可以帮助我们构建可复用、易于维护的模板结构。通过一些技巧，甚至可以自动化模板映射的生成，从而提高开发效率。
