Go模板中实现HTML主模板与子模板的嵌套包含（{{template}}）-Golang-PHP中文网

Go模板中实现HTML主模板与子模板的嵌套包含（{{template}}）

本文详解如何在go语言中通过html/template包构建可复用的html模板结构，使用template.new()方法创建命名子模板，并通过{{template "name" .}}语法实现主模板对子模板的嵌套包含，同时推荐基于文件的模板组织方式以提升可维护性。

本文详解如何在go语言中通过html/template包构建可复用的html模板结构，使用template.new()方法创建命名子模板，并通过{{template "name" .}}语法实现主模板对子模板的嵌套包含，同时推荐基于文件的模板组织方式以提升可维护性。

在Go Web开发中，将HTML结构拆分为主布局模板（layout）和内容模板（content）是标准实践，既能避免重复编写

等公共结构，又能保持逻辑清晰、易于维护。核心在于：*template.Template 不仅是一个模板，更是一个模板集合（collection）——它可容纳多个具名模板，彼此可通过 {{template "name" .}} 相互引用。

✅ 正确做法：使用 t.New("name").Parse(...) 构建模板集合

关键点在于区分两个同名但不同作用的 New：

template.New("main") 是函数，用于创建首个模板实例；
t.New("content") 是方法，在已有模板 t 上新增一个具名子模板，使其成为同一集合成员。

以下是一个完整、可运行的示例，模拟你项目中 index 与 compare 模板的整合：

package main

import (
    "html/template"
    "os"
)

const layout = `
<title>DC App</title><h1>Dashboard</h1>
{{template "content" .}}

`

const indexTmpl = `

` const compareTmpl = `Hours since {{.From}} are {{.Duration}}` func main() { // 1. 创建主模板（命名为 "layout"） t := template.Must(template.New("layout").Parse(layout)) // 2. 向同一集合中添加具名子模板 t.New("index").Parse(indexTmpl) t.New("compare").Parse(compareTmpl) // 3. 渲染时指定要执行的模板名（如 "layout"），并传入数据 data := struct{ From, Duration string }{"2024-01-01", "48"} // 渲染 "layout" 模板，它内部会调用 {{template "index" .}} 或 {{template "compare" .}} if err := t.ExecuteTemplate(os.Stdout, "layout", data); err != nil { panic(err) } }

⚠️ 注意：ExecuteTemplate 的第二个参数是目标模板名（如 "layout"），而非文件路径；第三个参数 . 将作为 pipeline 传递给所有被包含的模板（包括 {{template "content" .}} 中的 .）。

? 更佳实践：使用文件组织模板（推荐用于生产）

当模板增多、HTML变复杂时，硬编码字符串会严重损害可读性与协作效率。此时应改用文件方式：

templates/
├── layout.html
├── index.html
└── compare.html

layout.html：

anything-to-html
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。

下载
```
<title>{{.Title}}</title>{{template "content" .}}
```
index.html：
```
{{define "content"}}
```
{{end}}

compare.html：

{{define "content"}}
<p>Hours since {{.From}} are {{.Duration}}.</p>
{{end}}

加载与使用：

t := template.Must(template.ParseGlob("templates/*.html"))
// 或 template.ParseFiles("templates/layout.html", "templates/index.html", ...)

// 渲染时仍指定主模板名（自动匹配 layout.html 的根模板名）
t.ExecuteTemplate(w, "layout.html", data)

✅ 优势：