Go 模板原生不支持直接将 template 动作的结果赋值给变量（如 {{$var := template "name"}}），但可通过自定义函数配合 ExecuteTemplate 和 bytes.Buffer 实现模板内容捕获与变量化复用。
go 模板原生不支持直接将 `template` 动作的结果赋值给变量（如 `{{$var := template "name"}}`），但可通过自定义函数配合 `executetemplate` 和 `bytes.buffer` 实现模板内容捕获与变量化复用。
在 Go 的 text/template 包中，{{template "name"}} 是一个动作（action），而非表达式，因此不能作为右值参与赋值操作——这正是 unexpected <template> in operand</template> 错误的根本原因。要实现“捕获模板输出到变量”，需绕过语法限制，借助自定义模板函数完成：该函数在运行时动态执行指定命名模板，并将其渲染结果以字符串形式返回。
以下是标准、安全的实现方式：
✅ 正确做法：注册 execTempl 函数
package main
import (
"bytes"
"os"
"text/template"
)
var t *template.Template
// execTempl 执行指定命名模板，返回其渲染后的字符串
func execTempl(name string) (string, error) {
buf := &bytes.Buffer{}
err := t.ExecuteTemplate(buf, name, nil) // 第三个参数为数据上下文，可传入具体结构体
return buf.String(), err
}
func main() {
const tmpl = `{{define "my-template"}}Hello, {{.Name | default "World"}}!{{end}}
{{define "main"}}
Result:
{{$var := execTempl "my-template"}}
[{{$var}}]
Also usable in logic:
{{if eq $var "Hello, World!"}}Matched!{{else}}No match.{{end}}
{{end}}`
t = template.Must(template.New("").Funcs(template.FuncMap{
"execTempl": execTempl,
}).Parse(tmpl))
// 渲染主模板（需传入数据，例如 map[string]string{"Name": "Go"}）
if err := t.ExecuteTemplate(os.Stdout, "main", map[string]string{"Name": "Go"}); err != nil {
panic(err)
}
}
输出结果：
Result: [Hello, Go!] No match.
⚠️ 注意事项
-
模板作用域与嵌套：
execTempl中调用的模板必须已通过define定义且属于同一*template.Template实例（或已通过AddParseTree合并）。 -
数据上下文传递：示例中
ExecuteTemplate使用了nil上下文；实际使用时应传入所需数据（如结构体、map），确保子模板能正确访问.Field。 -
错误处理：
execTempl返回(string, error)，但在模板中调用时若出错，Go 模板引擎会中断渲染并返回错误——建议在开发阶段启用template.Error日志或预检模板逻辑。 -
性能考量：频繁调用
execTempl会重复创建bytes.Buffer并执行模板解析（若未缓存），对高并发场景建议结合sync.Pool复用缓冲区，或提前预编译常用子模板结果。
? 替代思路（仅限简单场景）
若只需静态内容复用，可改用 with + define + template 组合模拟“变量”行为（无动态计算能力）：
{{define "greeting"}}Hello, {{.Name}}{{end}}
{{with $data := .}}<!-- 模拟变量绑定 -->
{{template "greeting" $data}}
{{end}}
但这无法实现「捕获输出字符串」的核心需求。
综上，注册自定义函数是唯一健壮、通用的解决方案。它保持了模板的声明式特性，同时赋予了必要的灵活性，适用于组件化渲染、条件拼接、HTML 片段缓存等典型工程场景。
