Go html/template 复用布局时，可以用 define 定义公共布局和组件，用 template 按名称调用组件，用 block 为可替换区域提供默认内容。不同页面覆盖同一个 content 块时，应分别从公共布局克隆模板集合，再解析各自的页面定义，最后统一执行命名入口 layout。

如果页面只剩正文、公共页头不见了，或者首页突然出现关于页的内容，先查看执行入口与模板集合，而不是立即改 HTML。下文只讨论布局装配、命名调用与数据范围，不启动服务器，不执行示例，也不把结构图当作运行截图。官方文档：https://pkg.go.dev/html/template。

先区分空页面和布局缺失

三个常见表现对应不同问题：输出空白，可能执行的是只有定义、没有正文的根模板；只有页面内容，可能执行了 content 而不是 layout；多个页面显示相同正文，可能把它们的同名块解析进同一个集合，后面的定义改变了前面的内容。

先明确预期：页面应该共用 header 与 footer，中间 main 区域按页面替换。如果连这个结构都没有约定，调整文件顺序只会暂时掩盖问题。

分清 define、template 与 block

{{block "content" .}}默认内容{{end}} 是“定义 content，再以当前点调用它”的简写。页面装配时重新定义 content，布局调用的仍是这个名字，只是该集合中对应的内容不同。普通公共组件不需要默认覆盖能力时，用 define 加 template 就够了。

按模板名和数据范围定位原因

模板名与文件名不是同一个概念。本例根名称为 bundle，布局定义名称为 layout，调用时应明确写 ExecuteTemplate(..., "layout", ...)。不能只因为 Go 变量叫 base，就认为 base.Execute 会自动选择布局。

命名定义从根正文中被移出。因此，一个字符串若只包含 define 定义，根模板自身可能只留下空白。执行根不等于执行里面所有命名模板；这些定义需经命名调用或 ExecuteTemplate 进入。

再查看点的数据来源：{{template "header" .}} 把当前数据交给 header；省略管道的 {{template "header"}} 使用 nil 数据，不是自动继承调用处的点。子模板也不继承调用位置定义的局部变量。若布局被放在 with 或 range 内，当前点可能已经变化，应明确传入预期对象，而不是只看字段名是否相同。

克隆公共布局后装配每个页面

完整示例把模板放在字符串里，便于看清装配边界。保存为 main.go 后可由读者自行运行；这里没有执行。实际项目可以使用文件，但仍应保持“公共布局加当前页面”的组合，而不是把所有页面覆盖块混在一个集合。

package main

import (
    "bytes"
    "fmt"
    "html/template"
    "log"
)

// view 是布局和页面共同使用的数据契约。
type view struct {
    Title string
    Heading string
    Message string
}

const layoutText = `{{define "layout"}}



{{template "header" .}}
{{block "content" .}}
默认内容
{{end}}
{{template "footer" .}}


{{end}}
{{define "header"}}
{{.Heading}}
{{end}}
{{define "footer"}}{{end}}`

const homeText = `{{define "content"}}
{{/* 覆盖首页内容，仍接收布局传入的数据。 */}}
首页
{{.Message}}
{{end}}`

const aboutText = `{{define "content"}}
{{/* 相同块名存在于另一个独立模板集合。 */}}
关于页
{{.Message}}
{{end}}`

// assemble 在任何执行前克隆基模板，再追加当前页面定义。
func assemble(base *template.Template, page string) (*template.Template, error) {
    t, err := base.Clone()
    if err != nil {
        return nil, fmt.Errorf("克隆布局失败：%w", err)
    }
    t, err = t.Parse(page)
    if err != nil {
        return nil, fmt.Errorf("解析页面块失败：%w", err)
    }
    return t, nil
}

func main() {
    base, err := template.New("bundle").Parse(layoutText)
    if err != nil {
        log.Fatal(err)
    }
    home, err := assemble(base, homeText)
    if err != nil {
        log.Fatal(err)
    }
    about, err := assemble(base, aboutText)
    if err != nil {
        log.Fatal(err)
    }

    // 所有模板装配完成后，只执行明确的 layout 入口。
    pages := []struct {
        name string
        tmpl *template.Template
        data view
    }{
        {"首页", home, view{"首页标题", "欢迎访问", "首页正文"}},
        {"关于页", about, view{"关于标题", "了解站点", "关于页正文"}},
        {"默认页", base, view{"默认标题", "通用页面", ""}},
    }
    for _, page := range pages {
        var buf bytes.Buffer
        // 先写入缓冲区，模板执行失败时不输出半截页面。
        if err := page.tmpl.ExecuteTemplate(&buf, "layout", page.data); err != nil {
            log.Fatal(err)
        }
        fmt.Printf("%s：\n%s\n", page.name, buf.String())
    }
}

两个页面都使用 content 名称，但它们分别属于 home 和 about 的模板集合。Clone 复制关联模板的名称空间，随后在克隆体中 Parse 不会把页面覆盖块加到原始 base。先创建所有页面再开始执行，避免在 html/template 已执行之后继续解析或克隆。

header 通过布局传入的点读取 Heading；页面 content 读取 Message；footer 不依赖字段。这个共同数据契约让布局不必知道页面来自哪个文件。本例的输入是普通字符串，不为绕过模板问题而转换成特殊 HTML 类型；HTML 输出应使用 html/template，而不是替换为 text/template。

用默认块和页面差异判断装配结果

按代码定义推导：首页布局应包含“首页”小节与首页正文；关于页应包含“关于页”小节与关于页正文；未添加覆盖的 base 应显示“默认内容”。三个页面都应保留公共页头、页脚。这里只描述读者可观察的预期，没有提供伪造的 stdout、耗时或成功记录。

若后续自行尝试，可以从三个方向定位：默认页没有默认内容，查看 base 的 block 是否已被其他 Parse 改写；首页与关于页相同，查看是否误复用同一集合；字段读不到，查看调用是否传入正确的点及字段是否导出。

覆盖也有两个细节：在连续的 Parse 调用中，模板定义可以重新定义，但 html/template 要在首次执行前完成这些操作；只含空白和注释的定义被视为空，不会替换既有正文。如果确实需要隐藏默认区域，可以定义一个具有实际控制动作但不输出内容的块，例如 {{define "content"}}{{if false}}隐藏{{end}}{{end}}，不要假设空定义会擦除默认块。这不是推荐每页使用的技巧，只是解释空覆盖失效的原因。

保留一份布局维护清单

• 对外执行一个稳定入口名，例如 layout，不依赖根模板或文件排序。
• 公共组件名与页面替换块名分开；不同页面共享替换块名时，模板集合分开。
• 所有 Clone、Parse 在首次执行前完成，不在请求中修改已使用的集合。
• 命名模板调用显式传入数据；with、range 中留意点的变化。
• 处理 Parse 和 ExecuteTemplate 错误；需要完整页面才发送时先使用缓冲区。

block 是否必须覆盖？

不必。默认定义就是未覆盖页面的内容；没有默认内容需求时，也可以用普通命名组件组合。

为什么同一集合不能同时保存两套 content？

关联模板按名字查找，不按“当前页面文件”区分同名定义。需要同时保留不同页面变体时，使用独立集合，或者让页面入口调用不同名字的组件。

能否执行一次后再 Clone 增加页面？

html/template 的 Clone 在模板已执行后返回错误。应在初始化时完成公共模板及所有页面变体的构造，再进行渲染。

布局语法参考 https://pkg.go.dev/text/template，HTML 模板方法参考 https://pkg.go.dev/html/template#Template.Clone 与 https://pkg.go.dev/html/template#Template.Parse。先把入口、集合和数据三个范围讲清楚，再拆文件，公共布局就不会依赖碰巧正确的解析顺序。