如何在Go模板中调用子模板时传递自定义变量？

1. 子模板参数传递的正确方式 #

你尝试的{{template "topdoc" .title="Home" .otherParam="Checking..."}}写法不符合Go模板语法，Go模板传递参数给子模板只能通过单个管道值（结构体、map或自定义类型），不能直接拼接键值对。

实现步骤： #

• 定义页面数据结构体，统一管理常量变量：

type PageMeta struct {
    Title       string
    Description string
    // 可扩展其他字段如Keywords、Author等
}

• 在Gin处理器中传递数据到模板：

func homeHandler(c *gin.Context) {
    c.HTML(http.StatusOK, "home.tmpl", PageMeta{
        Title:       "Home",
        Description: "Checking...",
    })
}

• 修改基础模板topdoc.tmpl，直接引用结构体字段：

{{define "topdoc"}}
<!DOCTYPE html>
<html>
<head>
    <title>{{.Title}}</title>
    <meta name="description" content="{{.Description}}">
    <!-- 其他头部元素 -->
</head>
<body>
{{end}}

• 页面模板home.tmpl中引用子模板时传递整个数据对象：

{{template "topdoc" .}}
<!-- 页面主体内容 -->
<h1>Welcome to Home Page</h1>
{{template "botdoc" .}}

2. 模板块定义的正确用法（解决页面空白问题） #

用{{define "title"}}Home{{end}}导致空白，大概率是因为模板加载不完整或基础模板未正确引用自定义块。

实现步骤： #

• 修改基础模板topdoc.tmpl，使用block标签定义可覆盖的默认内容：

{{define "topdoc"}}
<!DOCTYPE html>
<html>
<head>
    <title>{{block "title" .}}Default Site Title{{end}}</title>
    <meta name="description" content="{{block "description" .}}Default Description{{end}}">
</head>
<body>
{{end}}

• 页面模板home.tmpl中先定义专属块，再引用基础模板：

{{define "title"}}Home{{end}}
{{define "description"}}Checking...{{end}}

{{template "topdoc" .}}
<!-- 页面主体 -->
<div class="content">Home page content here</div>
{{template "botdoc" .}}

• 确保Gin加载所有相关模板文件：

// 加载templates目录下所有tmpl文件，包括基础模板和页面模板
router.LoadHTMLGlob("templates/*.tmpl")

// 或者指定加载具体文件（适用于模板数量少的场景）
router.LoadHTMLFiles(
    "templates/topdoc.tmpl",
    "templates/botdoc.tmpl",
    "templates/home.tmpl",
)

3. 常见问题排查 #

• 模板文件路径要正确，Gin默认从项目根目录查找，若模板在子目录需写全路径；
• Go模板区分大小写，结构体字段（如Title）和模板引用（{{.Title}}）要严格一致；
• 若使用block标签，建议设置默认值，避免页面未定义块时出现空白内容。

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