Go模板嵌套问题：如何向模板传入任意内容及实现方法咨询

首先，Go模板原生提供了几种实用方式来实现你想要的“容器模板包裹任意内容”的需求，不需要依赖自定义带end的action（因为Go模板本身不支持这类自定义扩展），不过自定义函数可以作为补充方案。下面分几种方法详细说明：

方法1：使用{{ block }}指令实现插槽（推荐） #

block是Go模板原生的带块指令，专门用来定义可替换的内容插槽，非常适合做可复用的容器模板。

步骤1：定义带插槽的容器模板 #

{{ define "div-block" }}
<div style="display:block">
    <!-- 定义名为"inner-content"的插槽，默认内容为空 -->
    {{ block "inner-content" . }}{{ end }}
</div>
{{ end }}

步骤2：调用容器并填充插槽内容 #

在需要使用div-block的地方，先重新定义inner-content块的内容，再调用div-block模板即可：

示例1：填充另一个模板

<!-- 先定义插槽内容为header模板 -->
{{ define "inner-content" }}
    {{ template "header" . }}
{{ end }}
<!-- 调用容器模板，会自动渲染插槽内容 -->
{{ template "div-block" . }}

示例2：填充直接HTML内容

{{ define "inner-content" }}
    <ul>
        <li>1</li>
        <li>2</li>
    </ul>
{{ end }}
{{ template "div-block" . }}

如果需要在同一个模板中多次使用div-block，只需要每次重新定义inner-content块即可，新的定义会自动覆盖之前的。

方法2：通过上下文传递模板名称或内容 #

如果需要更灵活的参数传递，可以将目标模板名称或HTML内容放到渲染上下文中，让容器模板动态渲染。

方式A：传递模板名称 #

定义容器模板

{{ define "div-block" }}
<div style="display:block">
    <!-- 从上下文获取要渲染的模板名称，然后渲染 -->
    {{ template .ContentTemplate . }}
</div>
{{ end }}

在Go代码中传递上下文

// 准备渲染数据，指定要嵌入的模板名称
data := map[string]interface{}{
    "ContentTemplate": "header",
    // 其他需要的上下文数据
    "Title": "My Page",
}

// 渲染div-block模板
err := tmpl.ExecuteTemplate(os.Stdout, "div-block", data)

方式B：传递HTML内容 #

如果要直接传递HTML内容，需要确保内容不会被自动转义，所以要使用template.HTML类型：

定义容器模板

{{ define "div-block" }}
<div style="display:block">
    <!-- 直接输出HTML内容，不会被转义 -->
    {{ .HTMLContent }}
</div>
{{ end }}

在Go代码中传递内容

import "html/template"

data := map[string]interface{}{
    "HTMLContent": template.HTML("<ul><li>1</li></ul>"),
}

err := tmpl.ExecuteTemplate(os.Stdout, "div-block", data)

关于自定义函数和自定义action的问题 #

1. 能否通过自定义函数实现？ #

可以，但有局限性：

• 自定义函数可以用来渲染指定模板并返回字符串（比如写一个renderTemplate函数），但函数只能处理静态或预定义的内容，无法直接处理模板中的动态action（比如{{ if }}、{{ range }}等），因为函数的返回值是已经渲染好的字符串，不是模板语法。
• 如果只是传递静态HTML内容，自定义函数可以配合safeHTML来避免转义，但灵活性不如block方法。

示例自定义函数实现：

// 在Go代码中注册自定义函数
func renderTemplateFunc(t *template.Template) func(string, interface{}) (template.HTML, error) {
    return func(tmplName string, data interface{}) (template.HTML, error) {
        var buf bytes.Buffer
        if err := t.ExecuteTemplate(&buf, tmplName, data); err != nil {
            return "", err
        }
        return template.HTML(buf.String()), nil
    }
}

// 注册到模板
tmpl := template.Must(template.New("").Funcs(template.FuncMap{
    "render": renderTemplateFunc(tmpl),
}).ParseFiles("templates/*.html"))

然后在模板中使用：

{{ define "div-block" }}
<div style="display:block">
    {{ render "header" . }}
</div>
{{ end }}

2. 能否在Go模板中创建自定义action？ #

原生Go模板不支持自定义带end的块级action。Go模板的语法是固定的，仅支持内置的action（如{{ template }}、{{ block }}、{{ if }}等），无法扩展自定义的多部分action（即包含end的嵌套结构）。

如果需要类似自定义块级action的体验，只能通过前面提到的{{ block }}指令或者模板嵌套的方式模拟，这也是Go模板官方推荐的最佳实践。

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