Go html/template同名模板块覆盖问题的解决方法

你的推测完全正确：Go模板在解析时，同名的模板块会被最后解析的定义覆盖，所以a.tmpl的content块被后解析的b.tmpl覆盖，导致执行a.tmpl时显示b的内容。以下是两种无需重复解析模板的解决办法：

方案一：唯一命名内容块+动态引用 #

通过为每个子页面的内容块设置唯一名称，让基础模板根据参数动态渲染对应内容，避免块覆盖。

模板文件示例 #

base.tmpl

{{define "base"}}
<!DOCTYPE html>
<html>
<head>
  <title>{{block "title" .}}默认标题{{end}}</title>
</head>
<body>
  <header>{{template "header" .}}</header>
  <main>{{template .ContentBlock .}}</main>
  <footer>{{template "footer" .}}</footer>
</body>
</html>
{{end}}

{{define "header"}}<h1>通用头部</h1>{{end}}
{{define "footer"}}<p>通用底部</p>{{end}}

a.tmpl

{{define "a"}}
  {{template "base" .}}
{{end}}

{{define "a-content"}}
  <p>A页面专属内容</p>
{{end}}

b.tmpl

{{define "b"}}
  {{template "base" .}}
{{end}}

{{define "b-content"}}
  <p>B页面专属内容</p>
{{end}}

Go代码调用 #

// 一次性解析所有模板
tmpl, err := template.ParseGlob("templates/*.tmpl")
if err != nil {
    log.Fatal(err)
}

// 调用A页面：传递ContentBlock参数指定要渲染的内容块
err = tmpl.ExecuteTemplate(w, "a", map[string]any{
    "ContentBlock": "a-content",
})

// 调用B页面
err = tmpl.ExecuteTemplate(w, "b", map[string]any{
    "ContentBlock": "b-content",
})

方案二：克隆模板实例隔离命名空间 #

为每个子模板创建独立的克隆实例，确保每个实例的content块定义互不干扰，同时复用已解析的基础模板内容。

Go代码示例 #

// 一次性解析所有模板文件
allTmpl, err := template.ParseGlob("templates/*.tmpl")
if err != nil {
    log.Fatal(err)
}

// 为A页面创建独立模板实例
aTmpl, err := allTmpl.Clone()
if err != nil {
    log.Fatal(err)
}
// 重新解析a.tmpl，覆盖当前实例的content块
aTmpl, err = aTmpl.ParseFiles("templates/a.tmpl")
if err != nil {
    log.Fatal(err)
}

// 为B页面创建独立模板实例
bTmpl, err := allTmpl.Clone()
if err != nil {
    log.Fatal(err)
}
bTmpl, err = bTmpl.ParseFiles("templates/b.tmpl")
if err != nil {
    log.Fatal(err)
}

// 调用时直接使用对应实例
aTmpl.Execute(w, nil)
bTmpl.Execute(w, nil)

两种方案都能实现一次性解析所有模板，调用时无需重复解析页眉、页脚等通用内容：

• 方案一更轻量，适合简单场景；
• 方案二更安全，适合高并发或复杂模板场景，避免全局块覆盖的风险。

内容的提问来源于stack exchange，提问作者joshcollie