真正管用的是官方维护的YAML插件（作者Brandon Wamboldt），它提供完整scope划分并适配Sublime Text 4，安装后必须完全重启才能生效，否则语法不加载；需校验scope是否匹配如support.type.kubernetes，并配合yamllint实现真实语法校验。
YAML插件装哪个才真正管用
别装“Better YAML”或“YAML-tmLanguage”，它们要么已停更，要么只做基础缩进高亮。官方维护、适配最新 Sublime Text 4 的是 YAML 插件（作者 Brandon Wamboldt），它提供完整 scope 划分（如 support.type.kubernetes、support.constant.spring-boot），后续叠加 Ansible/K8s 语义才有可能。
安装后必须重启 Sublime，否则新语法定义不加载；如果右下角仍显示 Plain Text 或颜色极淡，说明插件根本没生效。
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS）→ 输入Package Control: Install Package→ 搜索并安装YAML - 安装完立刻重启 Sublime Text（不是关闭再打开单个窗口，是完全退出进程再启动）
- 打开任意
.yml文件，确认右下角显示的是YAML，不是YAML (JSON)或YAML-tmLanguage
为什么文件打开还是白底黑字
不是主题问题，也不是插件没装——是语法作用域（scope）没匹配上。Sublime 默认只识别缩进和冒号结构，apiVersion、kind、{{ item }} 这些全被当普通字符串处理，自然不着色。
常见现象：整页灰白、括号不匹配、关键字无区分。根本原因是当前语法没定义这些字段的 scope，或者缩进检测被禁用导致解析器直接放弃。
- 检查
"detect_indentation": true是否在Preferences → Settings中启用（默认开启，但有人会关掉） - 打开文件后，按
Ctrl+Shift+P→ 输入Set Syntax: YAML强制重载一次 - 光标停在
kind:上，按Ctrl+Shift+P→Developer: Show Scope Name，看输出里有没有support.type.kubernetes或source.ansible——没有就说明语义层没加载
校验不能只靠高亮，得配 yamllint
高亮 ≠ 正确。缩进错一位、spec: 下漏空格、ports: 写成 port:，高亮全崩，但 Sublime 不报错。真正防错要靠外部校验工具链。
SublimeLinter + SublimeLinter-contrib-yamllint 是目前最稳的组合，能实时标红缩进错误、重复 key、非法字符等。
- 先装
SublimeLinter，再装SublimeLinter-contrib-yamllint - 确保系统已全局安装
yamllint：pip install yamllint（推荐用 pipx 隔离环境） - 在
SublimeLinter.sublime-settings中配置"yamllint"的路径（如 macOS 上可能是/opt/homebrew/bin/yamllint） - 编辑时保存即触发校验，错误直接标红，比 GitLab CI 或
helm lint更早发现问题
自定义后缀（如 docker-compose.prod.yml）怎么绑定语法
Sublime 只认扩展名，不读文件内容。像 docker-compose.prod.yml 这种复合后缀，默认不会触发任何 YAML 语法，右下角永远是 Plain Text。
不能靠“Open all with current extension as…”解决，因为 .prod.yml 不是标准扩展名；必须修改对应插件的 .sublime-syntax 文件。
- 找到插件目录：
Packages/YAML Language Support/YAML (Docker Compose).sublime-syntax（路径因插件而异） - 编辑该文件，在
file_extensions列表里加一行：- docker-compose.prod.yml - 保存后，按
Ctrl+Shift+P→Reload Syntax Definitions，否则修改不生效 - 注意：改完只对新打开的文件生效；已打开的需手动点击右下角 →
Open all with current extension as…→ 再选一次
复杂点在于：不同场景要用不同语法包（K8s/Ansible/Docker Compose），它们的 .sublime-syntax 文件互不兼容，改错一个会影响其他类型文件的高亮。建议每个专用语法单独维护，别硬塞进同一个文件。
