如何在Helm模板中结合if条件语句与dict字典使用？

原写法不可行的原因 #

你尝试的{{- if .Value... dict ...}}写法不符合Go模板（Helm模板底层基于Go模板实现）的语法规则：
if是独立的流程控制语句，必须单独包裹在模板动作块（即{{ }}）中，不能和dict函数的参数列表混写在同一个动作块内，因此会直接触发语法报错。

正确实现方案 #

场景1：条件插入字典的指定键值对 #

如果仅需要在满足条件时才将某组键值对加入最终字典，可先初始化基础字典，再通过merge函数条件合并额外键值：

{{- /* 先初始化包含固定键值的基础字典 */}}
{{- $finalDict := dict "fixedKey1" "fixedValue1" "fixedKey2" "fixedValue2" }}

{{- /* 满足条件时合并额外的键值对 */}}
{{- if .Values.enableExtraConfig }}
{{- $finalDict = merge $finalDict (dict "extraKey1" "extraValue1" "extraKey2" "extraValue2") }}
{{- end }}

如果偏好单行写法，可搭配ternary三元函数实现：

{{- $finalDict := dict "fixedKey1" "fixedValue1" | merge (ternary (dict "extraKey" "extraValue") (dict) .Values.enableExtraConfig) }}

场景2：条件生成整个字典 #

如果需要在满足条件时才创建整个字典，直接将dict定义逻辑完整包裹在if控制块内即可：

{{- if .Values.enableFeature }}
{{- $featureDict := dict "featureKey1" "featureValue1" "featureKey2" "featureValue2" }}
{{/* 后续使用$featureDict的业务逻辑 */}}
{{- end }}

场景3：条件设置字典单个键的取值 #

如果不需要控制键是否存在，仅需要根据条件动态设置某个键的取值，直接在对应值的位置使用条件判断即可：

{{- $finalDict := dict "env" (ternary "prod" "dev" .Values.isProd) "region" .Values.region }}

常见注意事项 #

• Helm 3.0及以上版本原生支持变量重新赋值、merge、ternary等工具函数，低版本需先确认兼容性
• 多字典合并时，merge函数会用后序字典的同键值覆盖前序字典，可根据需要调整合并顺序
• 所有控制语句与函数调用需拆分到独立的模板动作块中，不要混写在同一个{{ }}内

内容的提问来源于stack exchange，提问作者Arthur Ávila