.yaml · application/yaml

YAML: YAML 資料序列化語言 (YAML Ain't Markup Language)

YAML 1.2 是一種對縮排敏感的資料序列化語言,支援 # 註解、錨點參照、多行字串以及以 --- 分隔的多文件資料流。

快速解答: YAML 1.2 是一種對縮排敏感的資料序列化語言,支援 # 註解、錨點參照、多行字串以及以 --- 分隔的多文件資料流。 Kubernetes 清單、GitHub Actions 工作流程、Docker Compose 檔案與人工編輯的設定檔。

結構類型階層式
人類可讀性高
支援巢狀結構支援
LLM Token 效率中
副檔名.yaml
MIME 類型application/yaml
最適合用於Kubernetes 清單、GitHub Actions 工作流程、Docker Compose 檔案與人工編輯的設定檔。

核心優勢

  • 支援行內 # 註解與簡潔的多行文字區塊,無須大括號包覆
  • 允許在單一檔案內透過 --- 分隔存放多份獨立文件
  • 為 JSON 的超集合,在維運設定場景具備極佳可讀性

限制與權衡

  • 僅靠空白縮排的微小失誤就可能靜默破壞整體結構
  • YAML 1.1 中未加引號的純量如 NO 或 ON 會被意外轉型為布林值
  • 複雜規範與錨點別名機制提高了解析實作複雜度

參考資料

在本機轉換與清理 YAML

相關工程指南

YAML 常見問題

什麼是 YAML 中的「挪威問題」(Norway problem)?

在 YAML 1.1 中,未加引號的國碼 NO 以及 yes/on/off 會被解析成布林值而非字串。對易歧義純量加上引號或轉為 JSON 檢視即可避開。

單一 YAML 檔案可以包含多份文件嗎?

可以。Kubernetes 清單常使用 --- 分隔多個資源物件,TxtTo 的 YAML 轉 JSON 支援多文件 loadAll 解析。

.yml 與 .yaml 副檔名有差別嗎?

沒有差別。兩者語法完全相同,官方建議使用 .yaml,而 .yml 在 CI 與 Docker 設定檔中依然常見。