sublime不报错也不高亮是因为默认yaml语法仅解析基础结构，不识别kubernetes语义字段；缩进错一位即退为plain text，必须安装yaml for kubernetes插件并手动绑定语法，同时关闭detect_indentation、启用translate_tabs_to_spaces。
YAML 文件缩进错位，Sublime 为什么不报错也不高亮？
因为 Sublime 默认的 YAML 语法解析器只认基础结构（冒号、短横线、缩进层级），不理解 spec、containers、volumeMounts 这些 Kubernetes 字段语义。一旦缩进错一位，比如 ports: 下少空一格，整行及后续所有内容会直接退回到 Plain Text 状态——不是颜色变浅，是彻底失去作用域识别，折叠失效、括号不匹配、关键字无着色。
这不是主题或配色问题，是语法文件没加载对。右下角显示 “YAML” 但全灰白，大概率是用了自带 YAML，而不是 YAML (Kubernetes)。
- 必须安装插件
YAML for Kubernetes（作者 mattfoster），不是 “Better YAML” 或泛用 YAML 插件 - 安装后重启 Sublime（部分版本不重启不加载新语法）
- 打开
deployment.yaml→ 点右下角语言名 →Open all with current extension as…→ 选YAML (Kubernetes) - 验证：
apiVersion:变蓝、kind:变绿、metadata.name:变紫；spec.containers[].ports[]可逐层折叠
按下回车不自动缩进？先查三件事
写 env: 后按回车，光标没自动跳到下一级缩进位置，不是插件问题，是配置链断了。自动缩进依赖三个条件同时成立：auto_indent 开启、语法识别正确、detect_indentation 不干扰。
- 确认用户设置里有
"auto_indent": true（Preferences → Settings – User） - 右下角必须显示
YAML (Kubernetes)，不是YAML或Plain Text；点它手动切换 - 关掉
"detect_indentation": true（默认开启），否则打开文件时它会扫描前几行并覆盖你的tab_size和translate_tabs_to_spaces - 推荐加这两行：
"tab_size": 2（K8s 官方推荐）、"translate_tabs_to_spaces": true（避免混用 Tab/空格）
缩进混乱了怎么救？别 Ctrl+A + Reindent
已有文件缩进混杂（比如部分用 Tab、部分用 2 空格、部分用 4 空格），直接 Reindent 会误伤字符串里的 \t 或注释对齐，导致 yaml: line X: did not find expected key 报错。
- 先开
"draw_white_space": "all"（用户设置），让空格显示为·、Tab 显示为→，一眼识别混用 - 手动删掉开头几行的
→（Tab），确保前 10 行统一为空格缩进 - 再执行
View → Indentation → Convert Indentation to Spaces（若灰掉，说明还有 Tab 残留） - 最后
View → Indentation → Reindent，它才真正按语法规则重排结构
yamllint 校验通过 ≠ K8s 能跑通
yamllint 只检查 YAML 语法规范：禁止 Tab 缩进、禁止 trailing spaces、禁止重复 key、要求 list item 前有短横线。它不会告诉你 image: nginx:latest 是否真实存在，也不会校验 serviceAccountName: 在当前 namespace 下是否已创建。
- 必须三者齐备才能真校验：
SublimeLinter（框架）+SublimeLinter-contrib-yamllint（插件）+ 系统级yamllintCLI（pip install yamllint） - 缺任一环，状态栏只显示
0 errors, 0 warnings，但kubectl apply -f仍可能报error converting YAML to JSON - 业务逻辑层校验必须靠
kubectl apply --dry-run=client -f file.yaml或kubectl create --validate -f（v1.29+ 已弃用）
最易被忽略的是：yamllint 默认规则不禁止 name: my-service 和 name: my-service 在同一 scope 重复——得在项目根目录加 .yamllint 并显式启用 key-duplicates 规则。
