[{"data":1,"prerenderedAt":221},["ShallowReactive",2],{"page-zh-TW":3,"article-list-zh-TW":127,"article-zh-TW-yaml-vs-json":153},{"id":4,"title":5,"body":6,"description":17,"extension":18,"eyebrow":19,"faqIntro":20,"faqLabel":21,"faqTitle":22,"faqs":23,"footerRule":42,"footerRuleLabel":43,"footerTagline":44,"guideIntro":45,"guideLabel":46,"guideTitle":47,"intro":48,"meta":49,"navigation":50,"openTool":51,"path":52,"pitfalls":53,"pitfallsIntro":66,"pitfallsLabel":67,"pitfallsTitle":68,"reasons":69,"referenceIntro":82,"referenceLabel":83,"referenceNoteLabel":84,"referenceRows":85,"referenceTitle":110,"seo":111,"seoTitle":112,"stem":113,"steps":114,"workflowLabel":124,"workflowTitle":125,"__hash__":126},"pages\u002Fzh-tw\u002Findex.md","YAML 轉 JSON 轉換器",{"type":7,"value":8,"toc":13},"minimark",[9],[10,11,12],"p",{},"不必將來源傳送到轉換伺服器，即可把 YAML 設定與資料轉成標準 JSON。",{"title":14,"searchDepth":15,"depth":15,"links":16},"",2,[],"在瀏覽器中將 YAML 轉換為有效 JSON。支援多文件、縮排、複製與下載，不需上傳檔案。","md","專注的 YAML 工作區","解答 YAML 中無法完整對應到 JSON 的部分。","05 \u002F 參考問答","YAML 轉換常見問題",[24,27,30,33,36,39],{"question":25,"answer":26},"我的 YAML 會被上傳嗎？","不會。解析、JSON 產生、複製與下載準備都在瀏覽器中完成。",{"question":28,"answer":29},"是否支援多個 YAML 文件？","支援。以 --- 分隔的文件會作為一個 JSON 陣列回傳。",{"question":31,"answer":32},"支援哪個 YAML 版本？","解析器採用 YAML 1.2 行為，可避免 YAML 1.1 中部分意外的布林值轉換。",{"question":34,"answer":35},"所有 YAML 功能都能轉成 JSON 嗎？","不能。JSON 的資料模型較小，註解、錨點、標籤與原始格式不會保留。",{"question":37,"answer":38},"YAML 錨點與別名會如何處理？","解析器會展開別名，JSON 接收解析後的實際值；錨點名稱、別名與合併語法不會保留。",{"question":40,"answer":41},"為什麼某個 YAML 值的類型改變了？","未加引號的 YAML 純量可能是字串、數字、布林值或 null。帶前導零的識別碼與類似日期的文字應加上引號。","瀏覽器本機處理、不需帳戶、輸出標準 JSON。","處理原則","將人類可讀設定轉換為嚴格資料的專用工具。","掌握彈性 YAML 文件轉換為嚴格 JSON 時最重要的細節。","02 \u002F YAML 筆記","謹慎處理 YAML，穩定產生 JSON。","將易讀的 YAML 轉成嚴格 JSON，提供清楚的語法回饋，且不需上傳內容。",{},true,"開啟轉換器","\u002Fzh-tw",[54,57,60,63],{"title":55,"body":56},"註解不是資料","YAML 註解有助閱讀，但不屬於解析後的值。JSON 無法保留註解內容及原本位置。",{"title":58,"body":59},"錨點會被展開","別名與合併鍵可減少 YAML 重複內容；JSON 結果只保留展開後的值，不保留錨點名稱與語法。",{"title":61,"body":62},"對應鍵必須成為字串","JSON 物件的鍵只能是字串。使用複雜鍵或非字串鍵的 YAML 對應需要額外檢查。",{"title":64,"body":65},"日期形式的文字建議加引號","不同 YAML 工具可能用不同方式解析類似日期的純量。若必須保留文字，請明確加上引號。","轉換會保留 JSON 能表示的資料。註解、排版及 YAML 特有功能沒有標準 JSON 對應語法，因此只能被解析或捨棄。","04 \u002F 轉換限制","JSON 無法繼續承載的資訊",[70,74,78],{"title":71,"body":72,"icon":73},"理解 YAML 的錯誤提示","解析失敗時保留行號與來源內容，不會只回傳空白結果。","lucide:scan-line",{"title":75,"body":76,"icon":77},"支援多文件","以 --- 分隔的 YAML 串流會轉成 JSON 陣列，不會靜默遺失文件。","lucide:layers-3",{"title":79,"body":80,"icon":81},"預設在瀏覽器本機執行","文字與本機檔案只在目前分頁處理，不需要帳戶或伺服器佇列。","lucide:shield-check","常見結構通常可以直接對應，但 YAML 的資料模型比 JSON 更豐富。將設定交給 API 或應用程式前，可先利用此表確認轉換結果。","03 \u002F 類型對應","轉換說明",[86,90,94,98,102,106],{"yaml":87,"json":88,"note":89},"name: Ada","\"name\": \"Ada\"","YAML 的純量字串和帶引號字串都會成為使用雙引號的 JSON 字串。",{"yaml":91,"json":92,"note":93},"enabled: true","\"enabled\": true","YAML 1.2 布林值會保留為布林值；yes 和 no 會視為字串。",{"yaml":95,"json":96,"note":97},"count: 42","\"count\": 42","一般整數和小數會成為 JSON 數字，並受 JavaScript 數字精度限制。",{"yaml":99,"json":100,"note":101},"items: [a, b]","\"items\": [\"a\", \"b\"]","區塊與流式序列都會成為 JSON 陣列，項目順序維持不變。",{"yaml":103,"json":104,"note":105},"value: null","\"value\": null","YAML 的 null 和空值通常都會轉換為 JSON null。",{"yaml":107,"json":108,"note":109},"--- \u002F ---","[{…}, {…}]","多份 YAML 文件會放入同一個 JSON 陣列，避免遺漏任何文件。","YAML 值轉成 JSON 後的樣貌",{"title":5,"description":17},"YAML 轉 JSON 線上轉換器 - 瀏覽器本機處理","zh-tw\u002Findex",[115,118,121],{"title":116,"body":117},"加入 YAML","貼上 YAML、載入內建範例，或選擇本機 .yaml、.yml 檔案。",{"title":119,"body":120},"本機轉換","瀏覽器依 YAML 1.2 解析資料，並序列化為標準 JSON。",{"title":122,"body":123},"使用結果","複製格式化 JSON，或下載 UTF-8 檔案供 API、應用程式、測試與遷移使用。","01 \u002F 轉換流程","從易讀設定到嚴格資料","onPCTeF2ri8p0GYYGMY1-2jaQaD8ramd5BACbdP0288",[128,133,138,143,148],{"slug":129,"title":130,"description":131,"eyebrow":132},"fix-invalid-yaml","如何修復無效 YAML","在轉換為 JSON 前，排查 YAML 的縮排、定位字元、冒號、引號與清單錯誤。","錯誤排查",{"slug":134,"title":135,"description":136,"eyebrow":137},"multiple-yaml-documents-to-json","將多個 YAML 文件轉換為 JSON","了解由 --- 分隔的 YAML 文件流如何轉換成清楚、可攜的 JSON。","YAML 文件流",{"slug":139,"title":140,"description":141,"eyebrow":142},"yaml-anchors-aliases-json","YAML 錨點和別名轉換為 JSON","了解 YAML 錨點、別名和合併鍵在轉換為 JSON 時如何展開。","錨點與別名",{"slug":144,"title":145,"description":146,"eyebrow":147},"yaml-data-types-to-json","YAML 資料類型如何轉換為 JSON","了解 YAML 字串、數字、布林值、null、日期和標籤值如何映射到 JSON。","資料類型",{"slug":149,"title":150,"description":151,"eyebrow":152},"yaml-vs-json","YAML 與 JSON：語法、優勢和轉換限制","比較 YAML 和 JSON 的語法、類型、註解、錨點，以及轉換過程中可能發生的資訊變化。","格式比較",{"id":154,"title":150,"body":155,"description":151,"extension":18,"eyebrow":152,"faqs":159,"intro":169,"meta":170,"navigation":50,"path":171,"relatedGuides":172,"sections":173,"seo":215,"seoTitle":216,"slug":149,"stem":217,"type":218,"updated":219,"__hash__":220},"articles\u002Fzh-tw\u002Farticles\u002Fyaml-vs-json.md",{"type":7,"value":156,"toc":157},[],{"title":14,"searchDepth":15,"depth":15,"links":158},[],[160,163,166],{"question":161,"answer":162},"處理YAML 與 JSON會改變原始資料嗎？","若操作只改變表示方式，資料含義原則上不應改變；但解析器可能展開別名、正規化數字、移除註解或選擇不同文字風格。應比較解析結構並核對目標系統規則。",{"question":164,"answer":165},"如何驗證結果可靠？","條件允許時，分別解析操作前後的內容、比較鍵名和值型別，再把結果交給真實目標程式測試。只靠肉眼比較可能漏掉 null、數字、布林值、編碼或重複鍵差異。",{"question":167,"answer":168},"哪些情況不適合自動轉換？","當來源使用實作專屬擴充、重複鍵、自訂標籤、承載維運資訊的註解，或包含無法安全表示的高精度數字時，不應無人監督地自動轉換。","YAML 和 JSON 都能表示物件與陣列，但它們面向不同的編寫和資料交換情境。",{},"\u002Fzh-tw\u002Farticles\u002Fyaml-vs-json",[144,139,134],[174,179,184,189,198,204,209],{"title":175,"paragraphs":176},"共同的資料模型",[177,178],"兩種格式都能表示映射、序列、字串、數字、布林值和 null。一般設定通常可以在不改變應用資料的情況下完成轉換。","JSON 使用大括號、方括號和逗號；YAML 主要依賴縮排和行結構。",{"title":180,"paragraphs":181},"YAML 獨有的功能",[182,183],"YAML 支援註解、錨點、別名、標籤、區塊字串和多文件流，JSON 沒有對應語法。","轉換時別名會展開，註解會消失，多個文件會放入一個陣列。",{"title":185,"paragraphs":186},"如何選擇格式",[187,188],"JSON 適合 API 和嚴格的機器交換；YAML 更適合由人維護的設定檔。","投入正式環境前，應檢查日期、大整數、非字串鍵和標籤值。",{"title":190,"paragraphs":191,"bullets":194},"可靠的逐步處理流程",[192,193],"應把YAML 與 JSON視為一次具明確輸入、預期結構與目標系統的資料轉換。先複製原文，在改變表示方式前完成驗證，再擷取一個足以重現問題的最小範例。如此才能區分語法錯誤與資料模型或應用程式錯誤。","每次只做一項修改，並在每次修改後重複相同驗證。自動化流程遇到解析錯誤時應直接失敗，不能發布殘缺或推測修正的結果。需要稽核時，應同時保留原始輸入與產生的檔案。",[195,196,197],"比較時要涵蓋建立、審閱、傳輸與讀取各階段，不能只看檔案外觀。","使用具代表性的真實資料測試，因為巢狀結構、重複鍵、註解與傳輸編碼都會影響實際結果。","明確定義唯一事實來源並自動轉換，避免兩份皆可編輯的檔案逐漸分歧。",{"title":199,"paragraphs":200,"code":203},"實例與驗證方法",[201,202],"下方範例刻意保持簡短，方便逐項核對。處理真實檔案時也應檢查每個鍵、純量型別、陣列順序與巢狀邊界，而不是只確認頁面顯示成功。","轉換或精簡成功只能證明來源文字可以解析。還應比較操作前後的結構化值，並用正式環境真正採用的程式庫或平台重新讀取結果，才能找出實作差異。","authoring YAML → validate → exchange JSON",{"title":205,"paragraphs":206},"限制與邊界情況",[207,208],"YAML 與 JSON的難點通常來自「語法有效」與「實際可用」之間的差異。解析器接受的資料仍可能缺少欄位、含義模糊、體積過大，或不符合目標系統的結構描述。","不要盲目修正或正規化陌生檔案。重複鍵、隱含型別、別名、數字精度、Unicode、換行符號與超大輸入都需要明確政策；目標系統規則較嚴格時，應以目標規則為準。",{"title":210,"paragraphs":211,"bullets":214},"正式環境檢查清單",[212,213],"發布前至少測試正常文件、空值、深層巢狀資料、非 ASCII 文字，以及一個刻意損壞的範例。若其他系統必須重現完全相同的輸出，還應記錄工具或相依程式庫版本。","當資料參與建置、部署、API 或設定時，應把驗證加入持續整合。上線前審查差異並保留回復副本，上線後觀察第一個實際使用端，不能把「語法通過」等同於「運作正確」。",[195,196,197],{"title":150,"description":151},"YAML 與 JSON 比較：語法差異與轉換指南","zh-tw\u002Farticles\u002Fyaml-vs-json","guide",null,"rjsnT5Stn0JKp2bUU3B37uEcTLHO0vUbZ17DufilikU",1791972536989]