装了插件仍灰白是因为sublime未加载专用语法定义；默认yaml语法只识别基础结构，不理解apiversion、kind等kubernetes语义字段，必须安装yaml for kubernetes插件、重启后手动绑定为“yaml (kubernetes)”语法，并关闭detect_indentation、启用translate_tabs_to_spaces。
为什么装了插件还是灰白一片？
不是插件没生效，是 Sublime 没加载对的语法定义。默认的 YAML 语法只认基础结构（冒号、短横线、缩进），不识别 apiVersion、kind、spec 这类语义字段——所以整页灰白，或只有极弱缩进变色。它把 containers: 当普通 key，{{ .Values.replicaCount }} 当纯字符串。
必须安装专用语法包，而不是“Better YAML”或“YAML Tools”这类泛用插件：
- Kubernetes 场景：装
YAML for Kubernetes（作者 mattfoster），安装后重启 Sublime - Ansible 场景：装
YAML for Ansible，再手动编辑其.sublime-syntax文件，在contexts里加- include: scope:source.jinja - Docker Compose 场景：装
YAML Language Support，然后手动绑定docker-compose.prod.yml等复合后缀
装完后，打开文件 → 点右下角语言名 → Open all with current extension as… → 选对应语法（如 YAML (Kubernetes)），别选默认的 YAML。
缩进错一位就全崩，怎么救？
YAML 解析器很严格：ports: 下少一个空格，从那行起全部退为 Plain Text，折叠失效、括号不匹配、关键字无着色。这不是 bug，是解析器主动放弃。
自动缩进要三者同时成立：
-
"auto_indent": true（用户设置里确认开启） - 右下角显示的是
YAML (Kubernetes)，不是YAML或Plain Text -
"detect_indentation": false（必须关掉！否则它会扫描前几行，覆盖你设的tab_size和translate_tabs_to_spaces）
推荐加这两行到用户设置：
"tab_size": 2, "translate_tabs_to_spaces": true
K8s 官方推荐 2 空格，且严禁混用 Tab/空格。
自定义后缀（如 .actrc、configuration.yaml）怎么高亮？
Sublime 只看后缀，不看内容。像 .actrc、configuration.yaml 这类文件，默认仍是 Plain Text，高亮和校验全失效。
两种办法：
- 临时：打开该文件 → 点右下角语言名 → Open all with current extension as… → 选
YAML或对应专用语法 - 永久：编辑对应插件的
.sublime-syntax文件（比如Packages/YAML for Kubernetes/YAML (Kubernetes).sublime-syntax），在file_extensions列表末尾加一行：- actrc（注意缩进必须是两个空格）
改完保存，按 Ctrl+Shift+P → 输入 Reload Syntax Definitions 生效。
格式化 ≠ 正确，校验 ≠ 逻辑合理
Pretty YAML 插件能统一缩进、补空格、重排键名，但它不会告诉你 image: nginx:laetst 拼错了 latest，也不会发现 replicas: "3" 是字符串而非整数（除非配了 yamllint 的 truthy 规则）。
真正防错靠外部工具链：
- 语法校验：装
SublimeLinter+SublimeLinter-contrib-yamllint，确保系统已装yamllint（pip install yamllint），项目根目录要有.yamllint文件 - 语义校验：K8s 用
kubectl apply --dry-run=client -f file.yaml，Home Assistant 用homeassistant --check-config，GitHub Actions 用act -b
这些得单独配成 Build System，不能指望插件自动跑。
