Go语言html/template嵌套模板传递结构体数据异常求助

我猜你遇到的大概率是嵌套的header.html无法访问到结构体数据的问题吧？毕竟你提到admin.html能正常显示数据，但预期效果没达到。结合我踩过的同类坑，给你梳理几个关键排查点：

1. 确保所有模板都被正确解析 #

不管用template.ParseFiles还是template.ParseGlob，必须把所有用到的模板文件都纳入解析范围，不然嵌套模板会找不到：

• 用ParseFiles时，要明确列出所有文件：

tpl, err := template.ParseFiles("header.html", "admin.html")
if err != nil {
    // 错误处理逻辑
}

• 用ParseGlob时，要确保匹配规则能覆盖目标文件：

tpl, err := template.ParseGlob("*.html")
if err != nil {
    // 错误处理逻辑
}

如果只解析了admin.html，嵌套的header模板会被忽略，自然拿不到传递的结构体数据。

2. 嵌套模板时必须传递上下文 #

在admin.html里引用header模板时，一定要把当前的结构体上下文传过去——也就是不能省略模板调用后的**.**！比如：

{{template "header" .}}
<div>User is {{.Name}}</div>

如果只写{{template "header"}}，header.html会拿到空上下文，根本访问不到结构体字段。

举个完整的示例：
你的结构体定义（注意字段首字母大写！）：

type User struct {
    Name string // 必须导出，首字母大写是Go模板访问字段的前提
}

header.html的模板定义：

{{define "header"}}
<header>当前用户：{{.Name}}</header>
{{end}}

3. 结构体字段必须是导出的 #

这是新手最容易踩的坑！Go模板只能访问首字母大写的导出字段，如果你的结构体字段是name string而不是Name string，那不管怎么传递上下文，模板里都拿不到值，只会显示空或者默认值。

4. 明确指定执行的目标模板 #

如果用ParseFiles解析了多个模板，默认执行的是第一个被解析的文件（比如header.html），所以你需要用ExecuteTemplate明确指定执行admin.html：

err = tpl.ExecuteTemplate(w, "admin.html", user)
// 不要用tpl.Execute(w, user)，否则会执行第一个解析的模板

你可以对照这几点逐一排查，大概率能解决问题——我之前就犯过忘记传.的错误，折腾了好久才发现是这么基础的问题。

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