关联上一问题：如何格式化转义字符串值，实现YML存储的Elasticsearch搜索模板可读

你之前尝试的所有方案失效，核心是把不同场景的语法混作一谈：

• 把Ruby的多行字符串语法、Shell的续行反斜杠、普通JSON的转义规则，直接套用到YML存储ES Mustache模板的场景里
• 误以为ES要求搜索模板的source字段必须是不带换行的单行转义字符串

1. 用YML原生多行块替代转义单行字符串 #

YML的块标量|本身就是为存储带换行的纯文本字符串设计的，不需要额外加转义符、句尾反斜杠，写的时候直接把格式化后的Mustache模板原封不动塞进去，完全不会触发解析错误。

正确的template.yml写法参考：

# 可正常解析的模板格式
template:
  script:
    lang: mustache
    # |标识后续缩进的所有内容都是source字段的原始字符串，无需手动转义
    source: |
      {
        "query": {
          "bool": {
            "must": {
              "match": {
                "line": "{{text}}"
              }
            },
            "filter": [
              {{#line_no}}
                {
                  "range": {
                    "line_no": {
                      {{#start}}
                        "gte": "{{start}}"
                        {{#end}},{{/end}}
                      {{/start}}
                      {{#end}}
                        "lte": "{{end}}"
                      {{/end}}
                    }
                  }
                }
              {{/line_no}}
            ]
          }
        },
        # 动态_source配置直接书写即可
        "_source": {{#toJson}}fields{{/toJson}}
      }

之前的写法为什么触发解析报错：

• 给source字段套了多余的单引号，还加了换行转义符\'，YML解析时会把这些单引号、反斜杠当成字符串的实际内容，传到ES端就成了非法的JSON开头
• 块标量|的层级用错了：之前你把整个JSON对象套在template: |下面，等于把YML本身的结构也当成了字符串内容，根本没有正确映射到script、source这些字段

2. 落地避坑点 #

• 不要混用其他语言的多行语法：Ruby的<<块写法、反引号多行格式、Shell的续行反斜杠、JSON的\n转义规则在YML块标量里完全多余，YML会自动把换行、缩进保留为字符串的原始内容
• Mustache对JSON结构里的空白字符无解析限制：ES内置的Mustache引擎在渲染时会自动忽略JSON结构里的多余换行、缩进，你写模板时按正常JSON缩进对齐，渲染出来的内容依然是合法的请求体，完全不影响搜索功能执行
• 之前那种把整个source挤成一行、满屏\"的写法，本质是没利用YML本身的字符串存储能力，硬把转义后的JSON结果塞进去，自然可读性极差

3. 前置校验步骤 #

写完本地先跑两步校验，避免线上报错：

• 用本地YML解析工具读取template.yml，打印source字段内容，确认没有多余的单引号、反斜杠转义字符，格式和书写时的缩进换行完全一致
• 把替换完占位符的渲染结果粘贴到JSON校验工具里，确认能通过合法JSON校验

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