Helm命名模板中如何保留缩进与空白字符？

你遇到的核心问题是Helm模板渲染时的多行内容缩进上下文丢失：命名模板输出的第一行能继承调用位置的缩进，但后续行只会使用模板内部的原始缩进，导致对齐错位。

最优解决方案（适配Helm 3.10+） #

利用Helm 3.10新增的.IndentLevel变量，它会自动获取模板调用位置的当前缩进空格数。修改你的命名模板，让所有输出内容基于这个动态缩进级别生成，无需在调用处额外添加indent/nindent：

{{- define "example.volumemounts.gcs" -}}
{{- if not .Values.local -}}
{{- nindent .IndentLevel "- name: /example/gcs-creds" }}
{{- nindent (add .IndentLevel 2) "value: gcs-key" }}
{{- end -}}
{{- end -}}

原理说明 #

1. .IndentLevel：自动获取调用位置的缩进空格数（比如你例子中volumeMounts:下的缩进是6个空格，.IndentLevel就返回6）
2. nindent N：在文本前添加N个空格并换行，避免生成多余空白行
3. add .IndentLevel 2：让value:行在调用缩进的基础上再增加2个空格，保持YAML的层级对齐

调用后的正确输出 #

spec:
  ...
  podTemplate:
    ...
    spec:
      containers:
        - name: my-container
          ...
          volumeMounts:
            - name: /example/gcs-creds
              value: gcs-key
            - name: some-other-volume-mount
              value: test

低版本Helm兼容方案（3.10以下） #

如果你的Helm版本低于3.10，无法使用.IndentLevel，可以将模板内容定义为无缩进的字符串，通过传递缩进参数的方式处理（只需在调用时传一次，比每次加nindent更简洁）：

模板定义

{{- define "example.volumemounts.gcs" -}}
{{- $indent := default 6 .indent -}} {{/* 默认缩进6个空格，适配常见场景 */}}
{{- if not .Values.local -}}
{{- nindent $indent "- name: /example/gcs-creds" }}
{{- nindent (add $indent 2) "value: gcs-key" }}
{{- end -}}
{{- end -}}

调用方式

volumeMounts:
  {{ template "example.volumemounts.gcs" (merge (dict "indent" 6) .) }}

这种方式依然能保证模板复用性，且只需在调用时传递一次缩进值（如果默认值不符合当前场景）。

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