Gin框架Base HTML模板复用异常：页面内容重复显示问题修复

问题根源在于Gin的模板引擎加载机制：当多个模板文件包含同名的模板块（比如这里的content）时，如果一次性加载所有模板（比如用LoadHTMLGlob），后加载的模板会覆盖之前的同名块，导致所有路由都渲染最后加载的那个模板的内容。

修复方案一：路由渲染时指定模板组合（推荐） #

不要一次性加载所有页面模板，而是在每个路由的处理函数中，明确传入基础模板+对应页面模板的数组，让Gin动态合并模板，这样每个路由会使用对应子模板的content块替换基础模板的对应部分。

示例代码：

package main

import (
    "net/http"
    "github.com/gin-gonic/gin"
)

func main() {
    r := gin.Default()

    r.GET("/page1", func(c *gin.Context) {
        // 传入模板数组：基础模板在前，子模板在后
        if err := c.HTML(http.StatusOK, []string{"base.html", "page1.html"}, gin.H{
            "title": "页面1",
        }); err != nil {
            c.AbortWithError(http.StatusInternalServerError, err)
        }
    })

    r.GET("/page2", func(c *gin.Context) {
        if err := c.HTML(http.StatusOK, []string{"base.html", "page2.html"}, gin.H{
            "title": "页面2",
        }); err != nil {
            c.AbortWithError(http.StatusInternalServerError, err)
        }
    })

    r.Run(":8080")
}

修复方案二：避免同名模板块（备选） #

如果坚持要一次性加载所有模板（比如用r.LoadHTMLGlob("templates/*.html")），可以给每个子模板的模板块命名为唯一标识，比如page1_content、page2_content，然后在基础模板中通过传入的变量判断要渲染哪个块：

base.html片段：

<!DOCTYPE html>
<html>
<head>
    <title>{{.title}}</title>
</head>
<body>
    {{if eq .page "page1"}}
        {{template "page1_content" .}}
    {{else if eq .page "page2"}}
        {{template "page2_content" .}}
    {{end}}
</body>
</html>

page1.html片段：

{{define "page1_content"}}
    <h1>这是页面1的内容</h1>
{{end}}

page2.html片段：

{{define "page2_content"}}
    <h1>这是页面2的内容</h1>
{{end}}

路由处理时传入page变量：

r.GET("/page1", func(c *gin.Context) {
    c.HTML(http.StatusOK, "base.html", gin.H{
        "title": "页面1",
        "page":  "page1",
    })
})

注意事项 #

• 优先使用方案一，逻辑更清晰，符合模板继承的常规用法。
• 禁止用LoadHTMLGlob一次性加载所有包含同名模板块的页面模板，这会导致模板覆盖问题。

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