Helm模板单引号转义问题：需生成含单个反斜杠的JSON输出

问题说明 #

用Helm模板给Shell容器生成命令时，需要对单引号做转义——手动写["f'\''first","second"]能满足Shell的转义要求，但通过Helm的toJson函数处理.Values.items时出了问题：

• template.yaml：

---
example: {{- .Values.items | toJson | nindent 2 }}

• values.yaml：

---
items: ["f'\''first", "second"]

• 当前输出：

---
example:
  ["f'''first","second"]

• 期望输出：

---
example:
  ["f'\''first","second"]

要是在values.yaml里写["f'\\''first","second"]，输出会变成["f'\\''first","second"]，多了多余的反斜杠，不符合需求。

解决办法 #

方法1：绕开toJson，手动构造字符串 #

toJson会自动处理字符串转义，导致单引号被合并成三个。直接用Helm的字符串拼接能力手动生成格式：

修改template.yaml：

---
example:
  [{{ range $i, $item := .Values.items }}{{ if $i }},{{ end }}"{{ $item }}"{{ end }}]

这样values.yaml里写items: ["f'\''first", "second"]时，输出会直接保留原始转义格式，得到想要的结果。

方法2：用printf+quote处理单个元素 #

如果需要更灵活的处理，对每个元素单独转义后再拼接：

修改template.yaml：

---
example: {{- printf "[%s]" (join "," (.Values.items | map "quote")) | nindent 2 }}

quote函数会给字符串加双引号，同时正确保留内部的'\'转义符，避免toJson带来的额外转义。

方法3：自定义模板函数（进阶） #

如果经常要处理这类Shell转义，在chart的templates/_helpers.tpl里定义自定义函数：

{{/* 处理Shell单引号转义的函数 */}}
{{- define "shell.escapeQuotes" -}}
{{- . | replace "'" "'\\''" | quote -}}
{{- end -}}

然后在模板中使用：

---
example:
  [{{ range $i, $item := .Values.items }}{{ if $i }},{{ end }}{{ include "shell.escapeQuotes" $item }}{{ end }}]

这时values.yaml里只需要写原始字符串items: ["f'first", "second"]，自定义函数会自动转义成"f'\''first"，最终输出符合要求的格式。

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