YAML 缩进错一位导致容器起不来，因 Kubernetes 解析器严格按空格数构建嵌套栈，缩进不一致会引发解析失败，使 containers、ports、env 等字段丢失或误解析，Pod 卡在 ContainerCreating 或异常退出。
为什么 YAML 缩进错一位，容器就起不来
因为 Kubernetes 解析器（如 kube-apiserver 底层的 yaml 库）不“看齐”，只“数空格”。它用缩进值构建嵌套栈，一旦某行缩进比上一行少却没结束当前块，或突然多出 1 空格却未定义新键，就会卡在 while scanning a simple key 或 did not find expected key —— 这时 kubectl apply 不报语法错误，而是直接跳过该字段，导致 containers 缺失、ports 被吞、env 变成字符串字面量，最终 Pod 卡在 ContainerCreating 或启动后无端退出。
- 常见诱因：手动对齐时按了 Tab、复制粘贴带隐藏空格、IDE 自动补全插件插入了不一致缩进
- 关键事实：
pyyaml和snakeyaml都严格拒绝 Tab，且同级键必须缩进量完全相等（比如全是 2 空格，不能有的 2 有的 4） - 验证方式：保存后运行
kubectl apply --dry-run=client -f deployment.yaml -o yaml，失败即说明结构非法；成功也不代表业务正确，仅表示能转成 JSON
如何让 Sublime Text 显形并锁定空格缩进
Sublime 默认不显示空白字符，你根本看不到哪行混了 Tab、哪行缩进多了一格。不解决这个，“格式化”只是把错误重新排版一遍。
- 打开设置：
Preferences → Settings – User，添加两行："draw_white_space": "all"和"detect_indentation": false -
"draw_white_space": "all"让空格显示为·，Tab 显示为→；一眼就能发现→name:或··name:vs····image:的不一致 -
"detect_indentation": false是关键——关掉自动探测，否则打开一个老文件（含 Tab），整个编辑器立刻切到Tabs: 4模式，你设的translate_tabs_to_spaces彻底失效 - 重启 Sublime 或对已打开文件执行
Ctrl+Shift+P → Reload Syntax才能生效
YAML (Kubernetes) 语法必须手动绑定，不能靠右下角显示
右下角写着 YAML ≠ 正确语法引擎在工作。Sublime 自带的 YAML 语法只认冒号和短横线，apiVersion、spec.containers 全是白的，折叠失效、高亮全无，缩进错位时直接整段变灰白——这不是主题问题，是作用域（scope）压根没加载 support.type.kubernetes。
- 装插件：
Ctrl+Shift+P → Package Control: Install Package → YAML for Kubernetes（作者 mattfoster，适配 v1.20–1.30+） - 安装后必须重启 Sublime（部分版本不重启不加载新语法）
- 打开任意
.yaml文件 → 点右下角语言名 →Open all with current extension as… → YAML (Kubernetes) - 验证是否生效：
apiVersion:变蓝、kind:变绿、metadata.name:变紫，且spec.containers[].ports[]可逐层折叠；若仍灰白，说明绑定失败
一键转换旧文件缩进，但得避开两个坑
已有配置文件混用 Tab 和空格，直接 Convert Indentation to Spaces 很危险：它会把字符串里的 \t、注释对齐用的空格也一并处理，破坏 YAML 合法性。
- 先确认右下角显示
Spaces: 2或Spaces: 4（不是Tabs: 4），否则菜单项会灰掉 - 若灰掉，说明 Sublime 检测到混合缩进——此时先手动删掉几行开头的
→（Tab），再重试 - 转换后立即执行
View → Indentation → Reindent，让嵌套结构按新缩进规则重算层级 - 别开
trim_automatic_white_space：它会在行尾悄悄删空格，而 YAML 中value: "foo "尾部空格是有语义的，删掉可能触发环境变量截断
真正防错不靠眼睛数空格，靠三件事：显形空白、锁定空格、绑定专用语法。缺一环，kubectl apply 就可能在凌晨三点把你叫醒。
