JSON ↔ YAML 互轉工具（雙向）
在左側貼上 JSON 即可在右側取得 YAML，反之亦然。兩個面板均可即時編輯並自動同步。包含格式化 JSON、交換方向和複製按鈕，所有轉換均在瀏覽器本地完成，資料不上傳。
運作原理
JSON 與 YAML 的歷史與用途
JSON（JavaScript Object Notation）由 Douglas Crockford 於2000年代初設計，以 JavaScript 物件字面語法為基礎，透過嚴格的雙引號、逗號和括號規則消除歧義，幾乎所有程式語言都內建了 JSON 解析器。其簡潔性使其迅速取代 XML 成為 Web API 的標準資料格式。
YAML（YAML Ain't Markup Language）由 Clark Evans 和 Ingy döt Net 於2001年創建，目標是提供更適合人類閱讀的序列化格式。YAML 1.2 是 JSON 的嚴格超集，所有有效的 JSON 都是有效的 YAML。YAML 額外支援注釋、縮排層級、多行字串和型別推斷，非常適合手動編輯的設定檔。
JSON vs YAML 的使用場景
JSON 適合機器消費的資料場景：REST API、資料庫記錄、服務間通訊和本地儲存。其嚴格語法確保所有語言的解析行為完全一致，是程式間資料交換的首選格式。
YAML 適合人工編輯的設定檔：Docker Compose、Kubernetes 清單、GitHub Actions 工作流程、Ansible Playbook 等工具預設使用 YAML。注釋功能便於內聯文件，縮排式層級比括號更直觀，對頻繁手動編輯的設定檔而言可讀性更高。
格式轉換的常見陷阱
YAML 對縮排極為敏感，一個空格的偏移就會改變整體結構，這是最常見的錯誤來源。此外，YAML 會自動推斷型別：裸露的 yes 會被解析為布林值 true，0755 可能被解析為八進位數字。本工具會自動為可能被誤解的字串加引號，以保留原始型別。
特殊字元是另一個挑戰。冒號後跟空格（: ）、井號（#）、花括號等字元若出現在字串首位，必須用引號包覆。本工具自動處理這些情況，但不支援錨點、別名和多行區塊標量等進階 YAML 功能，遇到時會顯示清楚的錯誤提示。
常見問題
›YAML 是 JSON 的超集嗎？
是的。YAML 1.2 是 JSON 的嚴格超集，所有有效的 JSON 文件都是有效的 YAML。反之不然：YAML 的注釋、錨點、區塊標量等功能在 JSON 中沒有對應項。
›YAML 主要用於什麼場景？
主要用於設定檔：Docker Compose、Kubernetes 清單、GitHub Actions、Ansible Playbook 等。適合開發者手動編輯的檔案。
›設定檔用 JSON 還是 YAML 更好？
人工編輯時 YAML 更友好，因為支援注釋且視覺層級清晰。機器生成或機器消費的設定用 JSON 更嚴謹。ESLint、Prettier、tsconfig 等工具通常兩種格式都支援。
›YAML 如何處理特殊字元？
包含「冒號+空格」、前導特殊符號（{、[、#）或看起來像布林值/數字的字串必須加引號。單引號停用所有跳脫，雙引號使用類似 JSON 的反斜線跳脫。本工具會自動在必要處添加引號。
›JSON 轉 YAML 會遺失資料嗎？
對 JSON 支援的型別（字串、數字、布林值、null、物件、陣列），轉換是無損的。為防止 YAML 型別推斷導致資料變形，本工具會對可能被誤解的字串自動加引號。
›Python 中如何將 YAML 轉為 JSON？
使用 PyYAML：import yaml, json; data = yaml.safe_load(open('file.yaml')); print(json.dumps(data, indent=2))。使用 safe_load 可避免執行任意 YAML 標籤，更安全。
›Node.js 中如何將 JSON 轉為 YAML？
可以使用 js-yaml 套件：const yaml = require('js-yaml'); const obj = JSON.parse(fs.readFileSync('file.json')); console.log(yaml.dump(obj))。零依賴方案則需自行撰寫序列化器，本工具即採用此方式。
›哪些 YAML 功能不被支援？
本工具不支援：錨點（&name）、別名（*name）、型別標籤（!!int 等）、多行區塊標量（| 和 >）、文件分隔符（---）。如需支援，請使用完整的 YAML 函式庫。
相關工具
最後更新: