Sublime Text需装JSONPlus和Elasticsearch Snippets插件实现DSL高亮与代码补全，配合格式化工具防400错误，并用SideBarEnhancements+Terminal调试，重点验证mapping字段类型与highlight路径一致性。
Sublime Text 本身不识别 Elasticsearch DSL 关键字，直接写 match、bool、aggs 不会着色，也不会提示——必须靠插件补足语义。
安装 JSONPlus + Elasticsearch Snippets 补基础高亮与模板
原生 JSON 高亮只管括号和引号，对 DSL 字段名完全无感。装这两个插件是最低成本的改进：
-
JSONPlus修复尾逗号、单引号误报，提升折叠准确率，让嵌套highlight或bool查询结构更易读 -
Elasticsearch Snippets提供term、range、multi_match等前缀展开，输tm<tab></tab>直出"term": {"field": ""}，避免拼错terme或漏引号 - 不推荐手动改
JSON.sublime-syntax：DSL 关键字太多（must、should、filter、highlight…），且不同 ES 版本字段有差异，维护成本高
用 JsPrettier 或 HTML-CSS-JS Prettify 自动格式化 DSL
ES 查询体嵌套深、缩进敏感，手敲容易漏 } 或错位。格式化不是锦上添花，是防止 400 Bad Request 的刚需：
-
JsPrettier默认走prettier，对 JSON 兼容好，但需额外装 Node.js；HTML-CSS-JS Prettify更轻量，纯 Python 实现，开箱即用 - 务必在用户设置中开启
"auto_indent": true和"detect_indentation": false，否则格式化后缩进可能被 Sublime 自动重置 - 别依赖“保存时自动格式化”：某些插件在文件类型为
JSON时才触发，而 ES 查询常存为.es或无后缀，建议手动按Ctrl+Shift+H（Windows）快速调用
通过 SideBarEnhancements + Terminal 直连 ES 调试
写完 DSL 不能只看语法高亮，得发请求验证结果。Sublime 没有内置 HTTP 客户端，但组合两个插件就能本地调试：
-
SideBarEnhancements右键菜单加“Open Terminal here”，直接在查询文件所在目录唤起终端 - 接着粘贴
curl -X GET "http://localhost:9200/my_index/_search" -H "Content-Type: application/json" -d @query.json，其中query.json就是当前 Sublime 编辑的文件 - 注意：
highlight字段若用了自定义pre_tags（如"<font color="red">"</font>），返回体里会带 HTML 标签，确保终端支持 UTF-8 且没被 shell 当作特殊字符转义
高亮字段名拼写错误是调试最大拦路虎
ES 对字段名大小写、下划线、嵌套路径极其敏感，highlight 里写错一个字母，返回体里就完全没有 highlight 字段，还不会报错——表面成功，实则失效：
- 检查点优先级：先确认索引 mapping 中目标字段确实是
"type": "text"（keyword类型不参与高亮） -
highlight的fields必须和query中实际检索的字段一致，比如query查content.keyword，highlight却写"content":{}，那就不会高亮 - 用
GET /my_index/_mapping看真实字段结构，别信文档或旧代码注释
真正卡住人的从来不是怎么配高亮颜色，而是 highlight 字段根本不出现在返回结果里——这时候该查 mapping，而不是调 pre_tags。
