北京
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是什么時候？那次花了多久，最后發現是什么低級錯誤？
特別聲明：以上內容(如有圖片或視頻亦包括在內)為自媒體平臺“網易號”用戶上傳并發布，本平臺僅提供信息存儲服務。
Notice: The content above (including the pictures and videos if any) is uploaded and posted by a user of NetEase Hao, which is a social media platform and only provides information storage services.
