Helm values.yaml重复定义global等同名根键是否生效及符合最佳实践

首先明确两个核心判断：

• 带重复根级键的配置完全无法达到预期的追加生效效果
• 该写法不属于Helm推荐实践，属于会直接引发配置错误的典型错误用法

为什么该写法不生效 #

YAML 1.2规范明确要求，同一映射层级下不允许出现重复的键名。Helm底层使用Go语言标准生态的YAML解析库处理values文件，遇到单文件内同层级重复键时，默认会用后出现的键值完全覆盖前面的同名键内容，不会做任何深度合并。
你给出的追加后配置，实际被解析后最终只会保留最后出现的两组配置，原有配置会全部丢失，实际生效的内容等价于：

global:
  secret: password

random-chart:
  secret1: password1

原本定义的global.foo、global.foo1、random-chart.fooo三个配置项会完全消失，和你预期的追加效果完全不符。部分严格模式的YAML校验工具甚至会直接对这类重复键抛出解析错误，导致Helm渲染流程直接中断。

正确的配置追加方式 #

根据你的使用场景，选对应方式即可：

• 如果你是直接修改静态values.yaml文件：直接把要新增的配置项写到已经存在的global、random-chart配置块内部，不要新建同名根键，正确的完整配置如下：

global:
  foo: bar
  foo1: bar1
  secret: password

random-chart:
  fooo: baar
  secret1: password1

• 如果你是运行时动态追加配置（比如CI/CD流程注入敏感信息、不同环境差异化配置）：把要追加的配置单独写到独立的override values文件中，不需要重复写原有配置，文件内容只保留新增项即可：

# override.yaml 追加配置文件
global:
  secret: password

random-chart:
  secret1: password1

执行Helm安装/升级命令时，按顺序传入多个values文件即可：

helm upgrade --install my-release ./my-chart -f values.yaml -f override.yaml

Helm原生会对多个-f传入的values文件、--set传入的键值做深度合并，同路径下的键不会互相覆盖非冲突项，最终生效的就是你预期的完整配置。

注意：Helm的多值合并逻辑仅作用于多个独立传入的配置源之间，单个YAML文件内部的重复键永远不会触发自动合并，不要混淆这两个逻辑。

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