好的，阿杰。下面是你所需的 第七章之一：Go Web 编程快速入门 – 模板（4）：组合模板与逻辑控制 的结构化大纲 + 内容。你可以将其作为文案，也可直接放入教程或文档中。我会包括 出站链接与参考资料，便于后续查验。

第 07.4 节：模板（4）——组合模板与逻辑控制

7.4.1 引言

在 Web 开发中，模板不仅要渲染数据，还要支持页面结构复用（头部／尾部／导航／子模板）以及在模板内部做 逻辑控制（条件判断、循环、模板嵌入／组合）。本节聚焦于 Go 的 html/template（或 text/template）包如何实现 组合模板 和 逻辑控制。

7.4.2 组合模板（多个模板文件／布局+视图）

概念

  • 组合模板是指一个页面由多个模板文件构成：如一个 layout.html（布局／基础结构）、若干 view.html（视图内容）、可能还会有 partial.html（复用片段）。
  • 在 Go 中可以使用 template.ParseFiles(...) 或 template.ParseGlob(...) 将多个模板文件一并加载。 (Stack Overflow)
  • 然后通过 ExecuteTemplate(w, "templateName", data) 指定渲染哪一个模板。 (pkg.go.dev)

示例

// main.go
tmpl := template.Must(template.ParseFiles(
    "templates/layout.html",
    "templates/index.html",
    "templates/header.html",  // partial
    "templates/footer.html",  // partial
))
http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
    data := PageData{ Title: "首页", Items: []string{"A","B","C"} }
    err := tmpl.ExecuteTemplate(w, "layout.html", data)
    if err != nil {
        http.Error(w, err.Error(), http.StatusInternalServerError)
    }
})


<!-- templates/layout.html -->
{{ define "layout.html" }}
<!DOCTYPE html>
<html>
<head><title>{{ .Title }}</title></head>
<body>
  {{ template "header.html" . }}
  <div id="content">
    {{ template "index.html" . }}
  </div>
  {{ template "footer.html" . }}
</body>
</html>
{{ end }}


<!-- templates/index.html -->
{{ define "index.html" }}
<h1>欢迎来到 {{ .Title }}</h1>
<ul>
  {{ range .Items }}
    <li>{{ . }}</li>
  {{ end }}
</ul>
{{ end }}

这样就实现了 布局 + 视图 +头尾 partial 的组合。通过这种方式，页面结构得以复用、视图清晰分离。

要点

  • 使用 {{ define "name" }} … {{ end }} 明确命名模板。
  • 加载模板时：ParseFiles 或 ParseGlob("templates/*.html")。 (Stack Overflow)
  • 使用 ExecuteTemplate(w, "layout.html", data) 指定渲染顶层模板。
  • 在布局模板中，通过 {{ template "childTemplateName" . }} 嵌入子模板。
  • 适合大型项目中将“公共布局／导航”“不同页面视图”“可复用片段”分开管理。

7.4.3 逻辑控制（条件判断、循环、变量、函数）

条件判断 (if、else)

模板内部可以根据数据内容决定是否渲染某个块。

{{ if .IsAdmin }}
  <p>欢迎管理员：{{ .UserName }}</p>
{{ else }}
  <p>欢迎用户：{{ .UserName }}</p>
{{ end }}

Go 文档中明确支持 if、else、else if。 (blog.gopheracademy.com)

循环 (range)

遍历 slice 或 map 常见场景。

<ul>
  {{ range .Items }}
    <li>{{ . }}</li>
  {{ else }}
    <li>无项目</li>
  {{ end }}
</ul>

range 后可跟 else，若集合为空则执行 else 块。 (DigitalOcean)

变量与管道（Pipelines）

  • 可以在模板中定义变量：{{ $v := .SomeValue }}。 (gohugo.io)
  • 管道（pipe）允许将前面结果传入函数：{{ .Name | upper }}。
  • 自定义函数可注入模板：在 Go 代码中 template.Funcs(funcMap)。 (Coding Explorations)

嵌套模板与 with

  • with 可用作语境缩短：{{ with .User }} … {{ end }}。
  • 嵌套模板可通过 {{ template "another" .SomePart }} 实现。

示例：视图中逻辑控制

{{ define "index.html" }}
<h1>{{ .Title }}</h1>
{{ if .ShowList }}
  <ul>
    {{ range .Items }}
      <li>{{ . }}</li>
    {{ end }}
  </ul>
{{ else }}
  <p>当前无可显示项目</p>
{{ end }}
{{ end }}

7.4.4 在 Web 应用中的实践建议

  • 将 公共 layout 模板 放入 templates/layouts/，将 页面视图模板 放入 templates/views/，将 片段 partial 放入 templates/partials/。如此结构清晰。
  • 启动时预解析所有模板：避免每次请求都 ParseFiles，提升性能。
  • 模板执行时传入 struct 或 map[string]interface{}，使视图层数据明确。
  • 逻辑控制不要过重：视图层主要负责展现，复杂逻辑应在 Go 代码中处理。
  • 安全提示：对于 HTML 输出，一定使用 html/template 而不是 text/template，避免注入风险。 (DigitalOcean)

7.4.5 总结

  • 通过组合模板，可以将页面布局、头尾、视图、片段模块化、复用化。
  • 通过模板逻辑控制（if/range/variables/pipelines），可让模板更加动态。
  • 在 Go Web 编程中，掌握这两点能显著提升视图层的可维护性和复用性。

📚 参考资料