Iris框架Go模板块渲染异常：页面复用其他文件define内容

Go 的 html/template 引擎中，同名的 {{define}} 块会被最后加载的模板文件覆盖。而你当前使用的 Iris HTML 视图引擎默认会扫描并加载 ./views 目录下的所有 .html 文件，导致后加载的文件里的 PageCSS 块覆盖先加载的，最终所有页面都显示目录中最后一个文件的对应块内容。

方法一：手动注册独立模板组（推荐） #

通过 Add 方法为每个页面单独注册包含布局和自身的模板组，确保各页面的 define 块互不干扰：

tmpl := iris.HTML("./views", ".html")
// 为 search 页面注册专属模板组：布局 + search.html
tmpl.Add("search.html", "_layout.html", "search.html")
// 为 view 页面注册专属模板组：布局 + view.html
tmpl.Add("view.html", "_layout.html", "view.html")
rp.RegisterView(tmpl)

// 路由逻辑保持不变
rp.Get("/search", func(ctx iris.Context) {
    ctx.View("search.html")
})
rp.Get("/view", func(ctx iris.Context) {
    ctx.View("view.html")
})

方法二：为 define 块设置唯一名称 #

修改模板文件，给不同页面的 CSS 块起独特名称，再在布局中根据页面标识动态调用：

1. 修改 view.html：

{{define "ViewPageCSS"}}
<!-- view 页面专属 CSS 内容 -->
{{end}}

2. 修改 search.html：

{{define "SearchPageCSS"}}
<!-- search 页面专属 CSS 内容 -->
{{end}}

3. 修改 _layout.html：

{{if eq .PageType "view"}}
    {{template "ViewPageCSS" .}}
{{else if eq .PageType "search"}}
    {{template "SearchPageCSS" .}}
{{end}}

4. 修改 Go 代码，在路由中传递页面标识：

rp.Get("/search", func(ctx iris.Context) {
    ctx.ViewData("PageType", "search")
    ctx.View("search.html")
})
rp.Get("/view", func(ctx iris.Context) {
    ctx.ViewData("PageType", "view")
    ctx.View("view.html")
})

方法三：按需加载模板（适合开发调试） #

关闭全局模板预加载，在每个路由 handler 中手动加载所需模板（生产环境不推荐，会影响性能）：

// 初始化时不自动加载任何模板
tmpl := iris.HTML("./views", ".html")
rp.RegisterView(tmpl)

rp.Get("/search", func(ctx iris.Context) {
    // 手动加载布局和 search.html
    if err := tmpl.Load("_layout.html", "search.html"); err != nil {
        ctx.StatusCode(iris.StatusInternalServerError)
        ctx.WriteString(err.Error())
        return
    }
    ctx.View("search.html")
})

rp.Get("/view", func(ctx iris.Context) {
    // 手动加载布局和 view.html
    if err := tmpl.Load("_layout.html", "view.html"); err != nil {
        ctx.StatusCode(iris.StatusInternalServerError)
        ctx.WriteString(err.Error())
        return
    }
    ctx.View("view.html")
})

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