本文详解如何在Go模板中让嵌套子模板（如{{template "navbar" .}}）正确访问顶层定义的变量，核心是显式传递数据上下文（.或自定义pipeline），而非依赖隐式继承——这是Go模板设计的关键约定。
本文详解如何在go模板中让嵌套子模板（如`{{template "navbar" .}}`）正确访问顶层定义的变量，核心是显式传递数据上下文（`.`或自定义pipeline），而非依赖隐式继承——这是go模板设计的关键约定。
在Go的text/template中，变量作用域不自动跨模板边界传递。即使你在主模板中通过{{$spirit_animal := "cat"}}定义了局部变量，该变量也无法被{{template "navbar" .}}调用的子模板直接访问——因为子模板执行时的.（即当前数据上下文）默认为nil，除非你显式传入。
✅ 正确做法是：将所需数据作为pipeline参数传递给template动作。语法为 {{template "name" pipeline}}，其中pipeline可以是.（整个数据对象）、.field（某个字段），甚至复合表达式（如struct{A, B string}{.X, .Y}）。
以下是一个完整可运行示例，展示如何让主模板与子模板共享同一份配置数据：
package main
import (
"os"
"text/template"
)
func main() {
// 配置数据：脱离二进制，可独立维护（如从JSON/YAML文件加载）
config := map[string]string{
"spirit_animal": "cat",
"spirit_predator": "dog",
"site_title": "My Awesome Site",
}
const tmplStr = `
{{define "header"}}<h1>{{.site_title}}</h1>{{end}}
{{define "animal_info"}}Your spirit animal is: {{.spirit_animal}}, and your spirit predator is: {{.spirit_predator}}.{{end}}
<!-- 主模板使用配置 -->
{{template "header" .}}
{{template "animal_info" .}}
<!-- 也可传递子字段 -->
{{template "animal_info" .}}
`
t := template.Must(template.New("main").Parse(tmplStr))
if err := t.Execute(os.Stdout, config); err != nil {
panic(err)
}
}
输出结果：
<h1>My Awesome Site</h1> Your spirit animal is: cat, and your spirit predator is: dog. Your spirit animal is: cat, and your spirit predator is: dog.
? 关键要点总结：
- 永远显式传递：{{template "name" .}} 是最常用且安全的方式，确保子模板获得完整数据上下文；
- 避免局部变量陷阱：{{$var := ...}} 定义的变量仅在当前模板块内有效，无法穿透到{{template}}调用中；
- 动态配置友好：配置数据（如map[string]string或结构体）可从外部文件（JSON/YAML/TOML）加载，无需重新编译二进制；
- 类型安全提示：若子模板需强类型字段，建议定义结构体而非map[string]string，便于编译期检查和IDE支持。
通过这种显式数据流设计，你既能保持模板逻辑清晰、解耦，又能实现真正的“配置即代码”——所有业务变量集中管理、热更新就绪。
