如何将所有Go模板存储到单个*Template变量中？

问题根源 #

你遇到的空白页面有两个核心原因：

1. 模板名称不匹配：用ParseFS加载模板时，模板默认名称是文件的完整路径（比如pages/home.tmpl），而非你使用的home.tmpl，导致执行时找不到目标模板；
2. 页面模板无主动渲染逻辑：你的home.tmpl仅定义了main块，没有触发布局模板的渲染，直接执行只会定义块而不输出任何内容。

修复步骤 #

1. 修改页面模板，添加布局调用 #

在每个页面模板（比如home.tmpl）末尾添加对布局模板的调用，确保执行页面模板时会触发完整的布局渲染：

{{ define "page-title" }}Home Page{{ end }}

{{ define "main" }}
<section>Some content...</section>
{{ end }}

<!-- 调用主布局模板，使用完整路径名 -->
{{ template "layouts/layout.tmpl" . }}

2. 保持模板加载代码（可微调） #

加载所有模板文件到单个*Template变量，确保布局、页面、组件都被正确加载：

func Load(templates fs.FS) (*template.Template, error) {
    // 加载所有模板文件，使用空字符串作为初始模板名称
    tmpl, err := template.New("").ParseFS(templates, "layouts/*.tmpl", "pages/*.tmpl", "partials/*.tmpl")
    if err != nil {
        return nil, err
    }
    return tmpl, nil
}

3. 执行正确的模板 #

调用ExecuteTemplate时，使用页面模板的完整路径名称：

// 渲染home页面
err := tmpl.ExecuteTemplate(w, "pages/home.tmpl", data)
if err != nil {
    http.Error(w, err.Error(), http.StatusInternalServerError)
    return
}

4. 组件模板调用方式 #

如果需要调用partials组件（比如account-form.tmpl），在布局或页面模板中使用完整路径：

{{ template "partials/account-form.tmpl" . }}

原理说明 #

Go模板系统中，{{ define }}仅定义模板块，不会自动输出。当执行页面模板时，会先完成所有块的定义，再调用布局模板；布局中的{{ block }}或{{ template }}会自动使用已定义的对应块内容，最终渲染出完整页面。

内容的提问来源于stack exchange，提问作者whit3.oc7opus