在go模板中，嵌套模板默认无法访问父模板定义的局部变量或外部传入的数据；必须显式将数据（如结构体、map等）作为参数传递给{{template}}调用，才能在子模板中使用该数据。
在go模板中，嵌套模板默认无法访问父模板定义的局部变量或外部传入的数据；必须显式将数据（如结构体、map等）作为参数传递给{{template}}调用，才能在子模板中使用该数据。
Go 的 text/template 包设计遵循“显式传递、作用域隔离”原则：每个模板执行时拥有独立的上下文（即 .），它不会自动继承调用位置的局部变量，也不会隐式访问外层模板的数据。这意味着：
- {{$x := "value"}} 定义的局部变量仅在当前模板块内有效，无法被 {{template "sub" .}} 调用的子模板访问；
- 子模板接收的数据完全取决于 {{template "name" pipeline}} 中 pipeline 的求值结果 —— 即你显式传入的内容。
✅ 正确做法：始终将所需数据作为第二个参数传递给 {{template}} 动作。常见模式是传入 .（当前上下文），尤其当顶层数据为 map 或 struct 时：
{{template "navbar" .}} // 将整个数据对象传入 navbar 模板
{{template "footer" .}} // 同样可访问 .spirit_animal、.spirit_predator 等字段
以下是一个完整可运行示例，展示如何让嵌套模板安全访问外部定义的变量：
package main
import (
"os"
"text/template"
)
func main() {
data := map[string]string{
"spirit_animal": "cat",
"spirit_predator": "dog",
}
const tmpl = `
{{define "main"}}
Your spirit animal is: {{.spirit_animal}}
{{template "predator" .}} // 显式传入整个 map
{{template "greeting" .spirit_animal}} // 传入单个值
{{end}}
{{define "predator"}}
→ Predator insight: {{.spirit_predator}} watches over you.
{{end}}
{{define "greeting"}}
→ Hello, {{.}} lover!
{{end}}
`
t := template.Must(template.New("example").Parse(tmpl))
t.ExecuteTemplate(os.Stdout, "main", data)
}
输出结果：
Your spirit animal is: cat → Predator insight: dog watches over you. → Hello, cat lover!
⚠️ 注意事项：
- 不要依赖 {{$.spirit_animal}} 在子模板中访问顶层数据：$ 指向初始执行时的根数据，但仅当子模板被 {{template "name" .}} 调用时才有效；若传入的是 .spirit_animal（字符串），则 $ 在子模板中将指向该字符串而非原始 map，导致 $.spirit_predator 报错；
- 若需在子模板中同时访问多个字段，推荐统一传入 .（根数据对象），而非拆分为多个参数；
- 所有变量名（如 spirit_animal）必须与 Go 数据结构中的字段名或 map key 严格匹配（区分大小写）；
- 模板定义顺序无关紧要，但 template.Must() 会在解析阶段校验所有引用模板是否存在。
总结：Go 模板的变量作用域是严格受限且显式的。要实现“一次配置、全局可用”，关键不是在模板里定义变量，而是在顶层统一组织数据（如 map 或 struct），并通过 {{template "name" .}} 将其完整、一致地注入每个嵌套模板 —— 这既避免了重复编译，又保证了数据可维护性与模板复用性。
