如何在Helm中引用含短横线的Values属性配置环境变量？

问题场景 #

在values.yaml中定义了带短横线的属性security.enable-mock-service，但在deployment.yaml中引用时遇到两种错误：

• 使用驼峰式名称{{ .Values.security.enablemockservice | quote }}：应用启动报错，提示无法绑定null值到布尔类型，因为未正确匹配到实际属性。
• 直接使用带短横线的名称{{ .Values.security.enable-mock-service | quote }}：Helm升级时触发解析错误：Error: UPGRADE FAILED: parse error at (project/templates/deployment.yaml:105): bad character U+002D '-'。

相关代码 #

values.yaml

security:
  enable-mock-service: "false"

原错误的deployment.yaml片段

- name: SECURITY_ENABLEMOCKSERVICE
  value: {{ .Values.security.enablemockservice | quote }}

可行解决方案（除宽松绑定外） #

1. 使用索引访问语法 #

Go模板的点语法不支持带短横线的key，但可以通过方括号索引语法访问，直接包裹带短横线的属性名：

修改后的deployment.yaml片段：

- name: SECURITY_ENABLEMOCKSERVICE
  value: {{ .Values.security["enable-mock-service"] | quote }}

这种方式能让Helm正确解析带短横线的属性名，直接获取对应的值。

2. 提前定义模板变量 #

如果需要多次引用该属性，或者希望代码更清晰，可以先将属性值赋值给一个模板变量，再引用变量：

修改后的deployment.yaml片段：

{{/* 先将属性值赋值给变量 */}}
{{ $enableMockService := .Values.security["enable-mock-service"] }}
- name: SECURITY_ENABLEMOCKSERVICE
  value: {{ $enableMockService | quote }}

变量定义后可在当前模板范围内重复使用，避免多次写复杂的索引路径。

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