Helm模板中如何迭代sprig函数list创建的变量？

问题重现 #

在Helm Chart模板中使用以下代码时出现错误：

{{ $appEnvs := list "dev" "uat" }}

{{- range $env := $appEnvs }}
...
{{- end }}

错误信息：

<$appEnvs>: range can't iterate over [dev uat]

直接将list写在range中（{{- range $env := list "dev" "uat" }}）可正常运行，但通过变量迭代就报错，尝试toYaml、tuple等方法均无效。

解决方案 #

1. 检查变量作用域 #

确保$appEnvs变量的定义与range语句处于同一作用域。如果变量是在if、with等局部块内定义的，块外无法访问该变量，会导致解析异常。

错误示例：

{{ if .Values.enableEnvs }}
{{ $appEnvs := list "dev" "uat" }}
{{ end }}
# 此处$appEnvs不在作用域内，会报错
{{- range $env := $appEnvs }}
...
{{- end }}

修正：将range移至变量定义的同一作用域内，或使用全局作用域变量（通过$.前缀定义，不推荐滥用）。

2. 确认变量类型未被意外转换 #

错误提示中的[dev uat]看起来是字符串而非切片，说明变量可能被其他代码意外转换成了字符串类型。可以添加调试代码确认变量类型：

{{- $appEnvs := list "dev" "uat" -}}
变量类型：{{ printf "%T" $appEnvs }}
变量值：{{ $appEnvs }}

正常情况下，类型应输出[]interface {}（切片类型）。如果输出是string，需排查模板中是否有toString、printf等操作将变量转为字符串。

3. 修正错误的转换尝试 #

你之前尝试的toYaml和tuple都是错误方向：

• toYaml会将切片转为YAML格式的字符串，迭代时会遍历每个字符，而非列表元素。
• tuple $appEnvs会将整个切片作为单个元素封装，迭代时只会得到完整的切片，而非单个元素。

正确的写法就是直接迭代变量，只要变量是合法的切片类型即可：

{{- $appEnvs := list "dev" "uat" -}}

{{- range $env := $appEnvs }}
当前环境：{{ $env }}
{{- end }}

4. 检查Helm版本兼容性 #

如果使用的是Helm 2.x版本（已停止维护），可能存在模板引擎的兼容性问题，建议升级到Helm 3.x版本，Sprig函数的支持更稳定。

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