YAML、JSON、XML 的取捨

核心結論:選 YAML 是因為它好讀、體貼人類(只靠空格與換行),但不代表所有設定檔都該用 YAML。格式的選擇取決於「寫給誰看、用在什麼情境」。

依情境選格式

情境格式
寫給人看YAML
機器對接 / 管理權限JSON
格式要嚴謹的大企業 / 老系統XML

YAML 的優點

  • Human friendly:好閱讀
  • 支援註解
  • 免標點符號:避免語法錯誤,但仍支援中括號做列舉
  • 多文件合併:透過 --- 分隔多份文件

我的回顧

.yaml 就等於 .yml,兩者並存是歷史遺毒。實務原則:

  • 專案內不混用副檔名,統一一種
  • 跟隨主流工具的慣例
  • 能優先選用 YAML 時就優先考慮