YAML Tools是Sublime Text中首选的YAML格式化插件，因其底层调用ruamel.yaml，能正确处理块标量、标签、锚点及模板变量，并默认保留字段顺序；需手动启用自动补全、冒号插入和2空格缩进。
Sublime Text 默认不支持 YAML 格式化，必须靠插件实现；真正能稳定处理 Kubernetes、Ansible、Helm 模板变量和缩进逻辑的，只有 YAML Tools 或 YAML Formatter，其他如 SublimePrettyJson 会直接破坏 YAML 结构。
为什么 YAML Tools 是首选
它底层调用 ruamel.yaml（非正则替换），能正确解析 | 块、!!str 标签、锚点 &ref 和模板变量 {{ item }}，且默认保留字段顺序（部分版本有例外，见后文）。安装后命令面板里会出现 YAML: Format Document，快捷键是 ctrl+alt+f（Windows/Linux）或 cmd+alt+f（macOS）。
常见错误现象：
- 按快捷键没反应 → 当前文件未被识别为 YAML：右下角状态栏应显示
YAML，不是Plain text或JSON；点一下手动选Set Syntax → YAML - 格式化后字段乱序 →
ruamel.yaml解析时默认重排，尤其在旧版插件中无“保持顺序”开关 - 缩进变成 4 空格 → 插件默认值可能不是 2，而
kubectl、helm等工具严格要求 2 空格
YAML Formatter 的替代方案与依赖配置
它也基于 ruamel.yaml，但依赖系统 Python 环境。若你已装好 Python 3.6+，终端运行：
pip install ruamel.yaml
然后在 Sublime 中打开 Preferences → Package Settings → YAML Formatter → Settings，确认 python_binary 路径正确（留空通常可自动探测）。默认快捷键是 ctrl+alt+l，不是 Sublime 通用的 ctrl+shift+I。
使用场景：
- 不想装额外 Python 包？选
YAML Tools（自带嵌入式解析器） - 已有成熟 Python 工具链，且需复用同一环境中的
ruamel.yaml版本？选YAML Formatter - 需要集成
yamllint校验？两个插件都支持，但需额外装SublimeLinter和SublimeLinter-contrib-yamllint
缩进、冒号与自动补全必须手动开
YAML Tools 默认关闭自动补全功能，写完 env: 回车后光标不会缩进，极易导致结构错层。必须修改用户设置：
打开 Preferences → Package Settings → YAML Tools → Settings，在右侧用户设置中加入：
{
"auto_insert_colon": true,
"auto_indent_on_enter": true,
"indent_width": 2
}
注意："indent_width": 2 是硬性要求，设成 4 会导致 kubectl apply 报 did not find expected key；改完无需重启，但已打开的文件需删个空格再触发格式化才生效。
字段顺序乱了怎么办
YAML 规范本身不保证顺序，但 helm template、kustomize、Home Assistant 等工具实际依赖 apiVersion、kind、metadata 出现在前面。原生 YAML Tools 使用 ruamel.yaml 时会重排，且当前版本（2026 年 4 月）仍无官方“保持顺序”开关。
临时对策：
- 对关键文件（如
deployment.yaml）禁用自动格式化，只手动调整缩进和冒号 - 用
yamlfmtCLI 替代：它比ruamel.yaml更倾向保留原始顺序，可通过 Sublime 构建系统调用 - 检查插件更新日志——部分 fork 分支已实验性支持
preserve_order参数，但尚未合并进主干
最易被忽略的一点：格式化只是美化手段，不能替代语义校验；yaml 文件是否合法，最终得靠 kubectl --dry-run、helm lint 或 yamllint 来验证。
