Kubernetes把2空格写成4空格，整个集群崩了3小时

2024年Stack Overflow调研显示，YAML是开发者最讨厌的配置格式第三名，仅次于XML和INI。但讽刺的是，它同时是Kubernetes、GitHub Actions、Docker Compose的默认语言——你每天骂它，却离不开它。

我见过凌晨三点被叫醒的SRE，原因只是某人把缩进从2空格改成了4空格。YAML不会报错说"缩进错了"，它会默默解析成完全不同的数据结构，然后你的Pod就起不来了。这种"沉默的背叛"比编译错误可怕十倍。

缩进是语法，不是风格

YAML用缩进表达层级，跟Python一样。但Python至少会抛IndentationError，YAML parser只会给你一棵歪掉的语法树。

规则只有两条：用空格，别用Tab；用2个空格，别用4个。Tab在YAML规范里是未定义行为，有些parser认，有些不认。2023年GitLab的一次全球服务中断，根因就是某个CI模板里混进了一个Tab字符。

VS Code用户现在就去改设置：workspace.json里加"editor.insertSpaces": true和"editor.tabSize": 2。YAML插件能实时标红缩进错误，但前提是你得先装上插件——很多人没装。

有个冷知识：YAML spec允许任意数量的空格缩进，只要同一层级一致就行。但2空格是社区事实标准，偏离这个标准就是给自己埋雷。团队协作时，把.yamllint.yml放进仓库根目录，强制indentation: {spaces: 2}，比任何code review都管用。

引号不是装饰，是防弹衣

YAML的自动类型推断是便利还是陷阱？看你怎么用。不加引号的值会被解析成字符串、布尔值、整数、浮点数或null，取决于内容。

最阴险的是布尔值。YAML 1.1（PyYAML等旧parser的默认版本）把yes/no/on/off都当布尔值。你的国家代码列表里有NO（挪威）？变成false了。配置项写on？变成true了。

安全法则：任何可能被误读的值都加引号。版本号"1.10"不加引号会变成1.1（浮点数）。电话字符串"0123"会变成83（八进制）。这些bug在预发布环境可能藏几个月，直到某个用户数据触发边界条件。

双引号支持转义序列（\n、\t、Unicode），单引号原样输出（不处理转义）。简单字母数字串可以裸奔，但问问自己：这个值以后会不会变成"1.0"或者"yes"？

多行字符串：选错风格，日志乱套

写shell脚本或SQL查询时，多行字符串的换行处理能逼疯人。YAML提供两种块标量风格，差别微妙但致命。

管道符|保留换行符，适合shell脚本。大于号>把换行转成空格，适合长段落文本。但等等——|后面还能跟-或+，控制末尾换行是否保留。

我见过一个生产事故：开发者用|写Dockerfile指令，末尾多了个换行，导致RUN命令拼接失败。镜像构建成功，但运行时行为诡异，调试花了六小时。

建议：在团队wiki里贴一张cheat sheet，写明什么场景用什么风格。别指望每个人去读YAML spec，那玩意儿比大部分编程语言规范还难啃。

锚点与别名：DRY的甜蜜陷阱

&定义锚点，*引用别名，<<合并键——这套机制让你能写一次配置，多环境复用。Helm values文件、Docker Compose多服务定义、CI矩阵，都是典型场景。

但锚点是在parser层面展开的，你的应用拿到的是展开后的数据，看不到复用关系。这意味着：调试时你看到的YAML和实际生效的YAML是两回事。

更隐蔽的问题是覆盖顺序。<<: *defaults后面再写同名键，会覆盖默认值。但如果defaults里嵌套了对象，浅合并还是深合并？取决于你的parser和版本。PyYAML和ruamel.yaml行为就不一样。

我的建议是：锚点别嵌套超过两层，合并逻辑写进文档，复杂场景直接用模板引擎（Jinja2、Go template）代替原生锚点。YAML不是编程语言，别把它用成编程语言。

lint不是可选项，是门禁

yamllint、prettier、vscode-yaml——这些工具能在保存时就拦住80%的错误。但2024年JetBrains的调研显示，只有31%的DevOps团队把YAML linting写进CI pipeline。

剩下的69%在干嘛？靠人眼review。人眼能发现2空格和4空格的区别吗？能发现某个yes其实是字符串"yes"吗？

GitHub Actions示例：在workflow里加一步yamllint，失败就阻断合并。成本几乎为零，收益是少几个凌晨三点的on-call。

最后说个细节：YAML spec有1.1和1.2两个版本，行为差异不小。你的parser默认用哪个？跑yamllint --version查一下，然后在配置里显式声明yaml-version: "1.2"。别让默认设置替你做决定。

你最后一次因为YAML格式问题debug是什么时候？那次花了多久，最后发现是什么低级错误？