Helm模板渲染时列表值无法保留原有格式如何排查解决

问题原因 #

模板中直接使用{{ .Values.args }}注入列表类型值时，Go模板引擎会调用默认对象字符串格式化逻辑输出内容，不会按YAML语法规则做序列化，最终出现元素引号丢失、内容异常拼接的问题，输出结果不符合YAML规范。

复现配置 #

• 错误模板配置（job.yaml）：

args: {{  .Values.args  }}

• Values配置（values.yaml）：

args: ["-c","echo 'test'; sleep 5"]

• 错误渲染结果：

args: [-c echo 'test'; sleep 5]

修复方法 #

方法1：使用内置toYaml函数（推荐） #

toYaml是Helm原生提供的序列化函数，可以将任意类型的Values值转换为符合YAML语法规范的文本，搭配nindent函数处理缩进对齐即可，模板修改为：

args:
{{- toYaml .Values.args | nindent 2 }}

渲染后得到合法YAML结构：

args:
- -c
- echo 'test'; sleep 5

该格式完全符合Kubernetes对容器args字段的格式要求，可直接正常生效。

方法2：range遍历手动渲染 #

如果需要自定义列表项的输出格式，可以通过range动作遍历列表逐行渲染，搭配quote函数可按需给元素加引号：

args:
{{- range .Values.args }}
  - {{ . | quote }}
{{- end }}

渲染结果：

args:
  - "-c"
  - "echo 'test'; sleep 5"

原理说明 #

直接插值列表对象时，Go默认的列表字符串化规则是将所有元素用空格拼接后包裹在方括号中，既不会生成YAML列表要求的-项前缀，也不会保留字符串元素的原始引号标记，最终输出的内容是非法YAML结构，无法被Kubernetes解析。

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