直接写 YAML 容易出错是因为 Kubernetes 资源定义对缩进、字段层级和大小写极其敏感，如 kind 写成 Kind 或 metadata 下少空格就会导致 kubectl apply 报错。
为什么直接写 YAML 容易出错？
因为 Kubernetes 的资源定义对缩进、字段层级、大小写极其敏感，kind 写成 Kind 或 metadata 下少一个空格，kubectl apply 就会报 error: unable to decode 或更模糊的 invalid character。Sublime Text 本身不校验 K8s 语义，但能通过插件和配置把错误“提前暴露”出来。
必须装的两个插件：YAML 和 Kubernetes Snippets
只装 YAML 插件（通过 Package Control 安装）能让 Sublime 正确识别 .yaml 文件、高亮嵌套结构、自动缩进；但光靠它没法补全 apiVersion 或 spec.containers 这类 K8s 特有字段。所以还得加 Kubernetes Snippets —— 它提供几十个常用资源模板，比如输入 dep + Tab 就展开 Deployment 基础结构，svc + Tab 展开 Service 模板。
- 安装后重启 Sublime，新建文件 →
Ctrl+Shift+P→ 输入Set Syntax: YAML，确保右下角显示 “YAML” - Snippets 默认用 2 空格缩进，若团队要求 4 空格，需在
Preferences → Settings – Syntax Specific中加"tab_size": 4 - 部分旧版 Snippets 里
Deployment模板仍用apps/v1beta2，实际应改为apps/v1，手动删掉再补全更稳妥
快速补全字段时怎么避免填错版本或字段路径？
比如想写 ConfigMap，输入 cm + Tab 后，模板里默认是 apiVersion: v1，这是对的；但若写 Ingress，旧 Snippets 可能给 extensions/v1beta1，而新集群基本要求 networking.k8s.io/v1。不能无脑 Tab。
- 补全后立刻检查
apiVersion：Pod/Service/ConfigMap/Secret 用v1；Deployment/StatefulSet 用apps/v1；Ingress 用networking.k8s.io/v1 -
spec下字段顺序不影响运行，但按官方文档习惯排：先replicas，再selector，然后template；template.spec里容器定义必须有name和image，漏任一都会被kubectl拒绝 - 字段名别靠记忆：
envFrom不是env_from，volumeMounts不是volume-mounts—— 复制官方示例里的字段名最保险
保存前用什么方式快速验证语法和基础结构？
Sublime 没内置 YAML 校验，但可以配一个轻量命令：用 yamllint（Python 工具）做本地预检，比等 kubectl apply 报错再改快得多。
- 先
pip install yamllint，然后在 Sublime 里Tools → Build System → New Build System，粘贴：
{
"cmd": ["yamllint", "-f", "parsable", "$file"],
"selector": "source.yaml"
}
YAMLLint.sublime-build，之后按 Ctrl+B 就能实时看到缩进错、冒号后缺空格等问题yamllint 不检查 K8s 字段合法性（比如 containerPort 写成 port 它不管），但它能拦住 80% 的低级格式错误真正卡住人的往往不是语法，而是字段嵌套层级——比如 env 是数组，每个元素是对象，必须带 - name: 和 value:；而 envFrom 是对象，下面直接跟 configMapRef:。这种差异光靠补全记不住，得常翻 K8s v1.28 API 文档 对着抄。
