本文详解了如何在Golang中利用`html/template`包实现高效、可复用的模板布局——通过定义统一的`layout.html`主模板（含`title`和`content`等可插拔区块），配合各页面模板（如`index.html`、`about.html`）仅专注填充对应区块内容，并在Go代码中使用`ParseGlob`批量加载、`ExecuteTemplate`按需渲染，轻松达成类似Web框架“母版页”的效果，让头部、底部、导航等公共结构一次编写、处处复用，显著提升HTML模板的可维护性与开发效率。

在Golang中使用模板布局，主要是通过html/template包来实现页面结构复用，比如公共的头部、底部或侧边栏。常见的做法是定义一个主布局模板（layout），然后让其他页面内容填充到指定区域，实现类似“母版页”的效果。

1. 定义基础布局模板

创建一个基础的HTML布局文件，比如 layout.html，包含通用结构和可替换的内容区块：

<main>
    {{template "content" .}}
</main>

<footer>
    <p>© 2024 版权所有</p>
</footer>

2. 创建具体页面模板

接着创建页面模板，如 index.html，它将继承并填充 layout 中的区块：

再比如 about.html：

3. 在Go代码中加载并渲染模板

使用Golang程序加载模板，并将数据传入进行渲染：

package main

import (
    "html/template"
    "net/http"
    "time"
)

var templates = template.Must(template.ParseGlob("templates/*.html"))

func renderTemplate(w http.ResponseWriter, tmpl string, data interface{}) {
    err := templates.ExecuteTemplate(w, "layout", data)
    if err != nil {
        http.Error(w, "无法渲染模板", http.StatusInternalServerError)
    }
}

func indexHandler(w http.ResponseWriter, r *http.Request) {
    data := struct {
        Now time.Time
    }{
        Now: time.Now(),
    }
    renderTemplate(w, "index", data)
}

func aboutHandler(w http.ResponseWriter, r *http.Request) {
    renderTemplate(w, "about", nil)
}

func main() {
    http.HandleFunc("/", indexHandler)
    http.HandleFunc("/about", aboutHandler)

    // 假设模板文件放在 templates/ 目录下
    http.ListenAndServe(":8080", nil)
}

注意：template.ParseGlob("templates/*.html") 会加载目录下所有模板文件，只要它们使用了 {{define}} 定义命名区块，就能被正确识别和引用。

4. 模板执行逻辑说明

当调用 ExecuteTemplate 并指定模板名为 "layout" 时，Go会执行 layout 模板中的结构，同时查找当前模板集中是否有名为 "title" 和 "content" 的区块，并将其插入对应位置。

• {{define "layout"}} 是主结构模板
• {{template "title" .}} 表示引入名为 title 的子模板
• {{template "content" .}} 引入内容区块
• 每个页面只需定义这些区块，无需重复整体结构

基本上就这些。通过这种方式，你可以轻松实现多页面共享布局，保持代码整洁且易于维护。

以上就是《Golang模板布局使用教程》的详细内容，更多关于的资料请关注golang学习网公众号！