Go 的 text/template 支持通过 {{template "name" pipeline}} 语法向 partial 模板传参，参数作为 .（当前上下文）注入，可直接使用或重命名为具名变量（如 $foo := .），实现灵活的局部模板复用。
go 中模板 partial 渲染与参数传递详解：go 的 `text/template` 支持通过 `{{template "name" pipeline}}` 语法向 partial 模板传参，参数作为 `.`（当前上下文）注入，可直接使用或重命名为具名变量（如 `$foo := .`），实现灵活的局部模板复用。
在 Go 的 text/template 包中，渲染 partial 模板并传递参数的核心机制不同于 Ruby 的命名参数风格，而是基于 pipeline + dot 上下文赋值。{{template}} 动作有两种形式：
- {{template "name"}}：以 nil 为数据上下文执行模板；
- {{template "name" pipeline}}：将 pipeline 的求值结果作为 .（即当前作用域的根对象）传入目标模板。
这意味着你无法像 {{template "partial1" foo=true}} 那样直接传命名参数，但可通过结构化数据或变量绑定实现等效效果。
✅ 正确用法：传基础值并用 . 或重命名访问
假设你有如下 partial 模板 _partial1.tmpl（注意：Go 模板不强制以下划线开头，但命名惯例可保留）：
<!-- _partial1.tmpl -->
<div>
text1
{{if .}}
text2
{{end}}
</div>
在父模板 parent.tmpl 中调用时，传入布尔值、字符串或任意支持的 Go 值：
<!-- parent.tmpl -->
<div>
{{template "_partial1.tmpl" true}} <!-- . = true → if 条件成立 -->
{{template "_partial1.tmpl" false}} <!-- . = false → if 被跳过 -->
</div>
✅ 进阶技巧：传结构体 + 在 partial 内重命名变量
若需多个逻辑变量（如 foo, bar），推荐传入一个匿名结构体或自定义 struct，并在 partial 中解构：
<!-- parent.tmpl -->
{{template "_partial1.tmpl" struct{Foo bool; Bar string}{Foo: true, Bar: "hello"}}}
<!-- _partial1.tmpl -->
{{ $foo := .Foo }}
{{ $bar := .Bar }}
<div>
text1
{{if $foo}}
text2 (foo is true, bar = "{{$bar}}")
{{end}}
</div>
更简洁写法（Go 1.19+ 支持字段访问链式调用）：
{{if .Foo}}...{{end}} <!-- 直接访问结构体字段 -->
⚠️ 注意事项
- 模板名 "partial1" 必须与文件名或 {{define "partial1"}} 中定义的名称严格一致；
- ParseFiles 或 ParseGlob 会自动注册所有模板，但 template 动作引用的名称必须已存在；
- 不要试图在 {{template}} 后直接写 foo=true —— Go 模板语法不支持关键字参数，这会导致解析错误；
- 若需复用复杂逻辑，建议用 {{with}} 或 {{range}} 配合结构体提升可读性；
- 所有传入值必须是 Go 模板支持的类型（基本类型、struct、map、slice、func 等），且字段需导出（首字母大写）。
✅ 完整可运行示例
// main.go
package main
import (
"html/template"
"os"
)
func main() {
t, err := template.ParseFiles("parent.tmpl", "_partial1.tmpl")
if err != nil {
panic(err)
}
t.Execute(os.Stdout, nil) // 根数据为 nil，不影响 partial 的 . 值
}
运行后输出：
<div>
<div>
text1
text2
</div>
<div>
text1
</div>
</div>
总结：Go 模板的 partial 参数传递本质是「上下文替换」，而非「键值对注入」。掌握 . 的语义、善用结构体和变量绑定（$foo := .），即可安全、清晰地构建可复用的模板组件。
