在 Kubernetes YAML 模板中复用子模板（如 pod.tmpl）时，常因缩进不一致导致 YAML 格式错误；Go 原生 template 动作不支持缩进，需结合自定义 include 函数与 indent 过滤器实现灵活缩进控制。
在 kubernetes yaml 模板中复用子模板（如 `pod.tmpl`）时，常因缩进不一致导致 yaml 格式错误；go 原生 `template` 动作不支持缩进，需结合自定义 `include` 函数与 `indent` 过滤器实现灵活缩进控制。
Go 标准库的 text/template 提供了 template 动作用于渲染命名模板，但它直接插入渲染结果、不经过管道处理，因此无法对其输出应用 indent 等过滤器。例如以下写法是无效的：
{{ template "pod" | indent 4 }} // ❌ 编译错误：template 动作不支持管道
正确方案是使用 include —— 一个返回字符串的函数（而非动作），它将模板渲染结果作为字符串返回，从而可链式调用 indent、nindent 等 Sprig 提供的文本处理函数。
由于 include 并非 Go 标准库内置函数，需手动注册。以下是推荐的初始化方式（兼容 Helm 外部场景）：
import (
"bytes"
"io"
"path/filepath"
"text/template"
"github.com/Masterminds/sprig/v3"
)
func renderTemplate(templatePath string, vars interface{}, out io.Writer) error {
t := template.New(filepath.Base(templatePath))
// 注册 include 函数：渲染指定模板并返回字符串
funcMap := sprig.TxtFuncMap()
funcMap["include"] = func(name string, data interface{}) (string, error) {
buf := new(bytes.Buffer)
if err := t.ExecuteTemplate(buf, name, data); err != nil {
return "", err
}
return buf.String(), nil
}
// 解析模板文件（支持多文件）
t, err := t.Funcs(funcMap).ParseFiles(templatePath)
if err != nil {
return err
}
return t.Execute(out, vars)
}
注册完成后，在模板中即可安全使用：
{{ if eq .Case "pod" }}
# 直接嵌入，无额外缩进
{{ template "pod" . }}
{{ end }}
{{ if eq .Case "service" }}
service:
# 整体缩进 4 个空格，使 pod 内容成为 service 的子字段
{{ include "pod" . | indent 4 }}
{{ end }}
⚠️ 关键注意事项：
-
include "pod" .中的.表示将当前上下文完整传入子模板，确保变量可访问； -
indent N在每行开头添加N个空格，但不会缩进首行前导空白；若需保留原始缩进结构并整体右移，推荐nindent N（Sprig 提供），它会先 trim 前导换行再缩进，更符合 YAML 场景； - 若子模板（如
pod.tmpl）自身以换行或空格开头，请在编写时保持首行无缩进，或用trim过滤器预处理：{{ include "pod" . | trim | indent 4 }}； - 避免在
include后混用printf或多层嵌套管道，复杂逻辑建议封装为自定义函数提升可读性。
通过 include + indent 组合，你既能复用模板逻辑，又能按需适配不同 YAML 层级结构，彻底解决嵌套缩进失准问题。
