sublime text 默认 yaml 高亮不支持 kubernetes 语义，需安装 yaml for kubernetes 插件并手动绑定后缀；缩进错误会导致高亮失效，须禁用自动检测、统一用空格缩进。
Sublime Text 默认的 YAML 高亮和缩进支持基本不可用——它只认 .yaml 和 .yml 后缀，不理解 Kubernetes、Ansible 或 Docker Compose 的字段语义，且对缩进错误零容忍。必须手动干预语法绑定、禁用 Tab、并按场景选对插件。
为什么右下角显示 YAML 却整页灰白？
这不是主题或配色问题，是 Sublime 根本没加载正确的语法解析器。默认的 YAML 语法只识别基础结构（冒号、短横线、缩进层级），但把 apiVersion:、spec:、services: 全当普通 key 处理，作用域（scope）压根不是 support.type.kubernetes 或 source.docker-compose。
- 现象：打开
deployment.yaml后只有缩进微弱变色，kind:和metadata.name:都是白色 - 验证方法：按
Ctrl+Shift+P→ 输入Developer: Show Scope Name，光标停在spec:上，如果显示source.yaml而非source.kubernetes-yaml，说明语法没切对 - 根本原因：Sublime 不扫描文件内容（比如不看
apiVersion: apps/v1），只靠后缀或人工指定来决定用哪个语法
如何让 Kubernetes YAML 正确高亮？
必须换掉默认语法引擎，不能靠“调主题”或“重装 Sublime”。社区维护的 YAML for Kubernetes（作者 mattfoster）是目前最稳定的选择，适配 v1.20–1.30+。
- 安装：按
Ctrl+Shift+P→Package Control: Install Package→ 搜索并安装YAML for Kubernetes - 绑定：重启 Sublime（部分版本不重启不加载新语法），打开任意
.yaml文件 → 点右下角语言名 →Open all with current extension as…→ 选YAML (Kubernetes) - 验证：正常生效时，
apiVersion:变蓝、kind:变绿、metadata.name:变紫，且spec.containers[].ports[]支持逐层折叠 - 注意：
docker-compose.prod.yml这类复合后缀不会自动匹配，得进插件目录下的YAML (Kubernetes).sublime-syntax，在file_extensions列表里手动加一行- docker-compose.prod.yml
缩进错一位，高亮直接全崩？
不是 bug，是 YAML 解析器主动放弃。YAML 对缩进极其敏感，一旦某行缩进比上一行少却未结束结构（比如 ports: 下漏空格），从那行起全部降级为 text.plain，连括号匹配和折叠都失效。
- 必须统一设为纯空格缩进：
"translate_tabs_to_spaces": true+"tab_size": 2+"detect_indentation": false（写在Preferences → Settings） - 已有文件混用 Tab/空格？用
Ctrl+Shift+P→ 输入Convert Indent to Spaces强制转换 - 多行字符串（
|或>）含空行时，折叠可能提前终止；这类内容建议改用双引号包裹避免解析干扰 - 老版本 Sublime（&ref）和别名（
*ref）支持不完整，容易导致后续块解析错位
怎么让 docker-compose.yml 或 .k8s.yaml 自动高亮？
Sublime 默认只认 .yaml/.yml，其他文件名必须手动绑定或扩展语法映射。
- 临时方案：打开
docker-compose.yml→ 右下角点语言名 →Open all with current extension as…→ 选YAML (Docker Compose)（需先装YAML Language Support插件） - 永久方案：菜单
Preferences → Settings – Syntax Specific，右侧加：{"extensions": ["yaml", "yml", "k8s.yaml", "helm.yaml", "config"]} - 注意：扩展名不支持通配符（
*.yaml无效），也不区分大小写，但CONFIG不会匹配config - 自定义语法文件（如
Packages/User/MyK8s.sublime-syntax）必须放在Packages/User/目录，且file_extensions字段要明确列出目标后缀
真正麻烦的从来不是高亮颜色——而是高亮让你误以为“看着对就没错”。image: nginx:laetst（拼错 latest）、replicas: "3"（字符串而非整数）、matchLabels 和 template.metadata.labels 键值不一致，这些 Sublime 一概不报。高亮只是语法结构的视觉反馈，校验得靠 kubectl apply --dry-run=client -f 或外部 linter。
