.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
相關工程指南
- JSON vs YAML vs TOML vs .env:工程設定檔格式實戰指南跨註解支援、巢狀能力、機密安全性與生態系比較 JSON、YAML、TOML 與 .env 四大設定格式,並於瀏覽器本機安全互轉。
- 為何伺服器端貼上工具容易外洩機密——零上傳瀏覽器架構詳解了解把 .env、JWT、客戶 CSV 或機密合約貼進雲端轉換器的資料外洩風險,並學習如何親自驗證本機 0 位元組上傳。
- 如何在 AI 分析前於本地遮蔽 CSV 與 JSON 客戶資料在瀏覽器記憶體中依欄位遮蔽 CSV、等比例縮放財務金額(×k)並依鍵路徑脫敏巢狀 JSON,100% 保持語法合法。
- XML 轉 JSON:完整保留屬性、CDATA 區塊與 RSS 訂閱結構在瀏覽器記憶體中將 XML、RSS 與 SVG 無損轉為 JSON,完整保留 @_ 屬性前綴、CDATA 文字塊、數值型別並支援往返生成 XML。
相關格式
全部 24 種格式YAML 常見問題
什麼是 YAML 中的「挪威問題」(Norway problem)?
在 YAML 1.1 中,未加引號的國碼 NO 以及 yes/on/off 會被解析成布林值而非字串。對易歧義純量加上引號或轉為 JSON 檢視即可避開。
單一 YAML 檔案可以包含多份文件嗎?
可以。Kubernetes 清單常使用 --- 分隔多個資源物件,TxtTo 的 YAML 轉 JSON 支援多文件 loadAll 解析。
.yml 與 .yaml 副檔名有差別嗎?
沒有差別。兩者語法完全相同,官方建議使用 .yaml,而 .yml 在 CI 與 Docker 設定檔中依然常見。