指南

XML 轉 JSON:完整保留屬性、CDATA 區塊與 RSS 訂閱結構

在瀏覽器記憶體中將 XML、RSS 與 SVG 無損轉為 JSON,完整保留 @_ 屬性前綴、CDATA 文字塊、數值型別並支援往返生成 XML。

4 分鐘閱讀

快速解答: 要在將 XML、RSS 或 SVG 轉為 JSON 時不遺失中繼資料,請維持「忽略屬性」關閉並採用 @_ 屬性前綴。TxtTo 會在本地驗證 XML 行列語法錯誤、將 CDATA 區塊解包為乾淨 JSON 字串、於開啟「解析標籤值」時自動識別數值與布林型別,並支援將 @_ 屬性無損還原為合法 XML。

為什麼 XML 屬性、文字節點與 CDATA 在轉 JSON 時容易失真

不同於扁平的 JSON 鍵值對物件,XML 元素常同時夾帶標籤屬性、內部文字、重複的同層節點,以及包含未跳脫 HTML 或程式碼的 CDATA 區塊。

陽春的轉換程式往往直接捨棄 XML 屬性,或將重複出現的 RSS item 節點輸出成不一致的結構,導致後續 TypeScript 型別推導與 API 解析失敗。

  • 像是 id="bk101" 這類元素屬性寫在起始標籤內,而非子層鍵名。
  • RSS 中重複出現的 item 同層元素必須統一摺疊為 JSON 陣列。
  • CDATA 區段內常包含帶有 < 與 & 符號的 HTML 片段,無須字元實體跳脫即可直出。
xml
<catalog currency="USD">
  <book id="bk101">
    <title><![CDATA[Browser <em>XML</em> Guide]]></title>
    <price>39.00</price>
  </book>
</catalog>

精準控制 ignoreAttributes、attributePrefix (@_) 與 parseTagValue

TxtTo 於瀏覽器記憶體內執行 fast-xml-parser,讓你無須將企業介面報文或私有 RSS 訂閱傳送至雲端,即可即時調整屬性保留與型別解析選項。

建議維持 ignoreAttributes 關閉並保留 @_ 前綴,讓屬性鍵名與子標籤明確區隔;若檔案內含有須保留前導零的郵遞區號、發票號碼或 SKU 編號,請關閉 parseTagValue,避免 00412 被轉成數字 412。

json
{
  "catalog": {
    "@_currency": "USD",
    "book": {
      "@_id": "bk101",
      "title": "Browser <em>XML</em> Guide",
      "price": 39
    }
  }
}

在本機將 XML、RSS 與 SVG 轉為 JSON

本地驗證異常 XML 並檢視 RSS 或 SVG 樹狀結構

在執行解析前,XMLValidator 會先於本地檢查格式良構性,並以精確行號與欄號標出未閉合標籤或錯位屬性,協助你及早攔截截斷的 RSS 或毀損的 SVG 檔案。

轉換完成後,可直接開啟 JSON 格式化工具,在樹狀檢視中展開深層結構、依鍵名排序或修復後續手動編輯遺留的尾隨逗號。

使用 JSON 格式化與樹狀檢視檢查結構

選項預設值處理行為何時調整
ignoreAttributesfalse於 JSON 中保留所有 XML 標籤屬性僅在屬性屬於無用版面提示時啟用
attributePrefix@_為屬性鍵名加上 @_ 前綴若下游介面約定使用 _ 或 $ 時修改
parseTagValuetrue自動將數值與布林文字轉為原生型別須保留如 00412 前導零時關閉
indent2以 2 個空白縮排美化輸出 JSON設為 0 可產出單行壓縮 JSON

透過 rootName 與 includeDeclaration 將 JSON 往返轉回 XML

由於合規 XML 必須具備單一外層根元素,JSON 轉 XML 會自動將頂層陣列以 <item> 包裝在指定的 rootName(預設為 root)標籤中,並在啟用 includeDeclaration 時補上 <?xml version="1.0" encoding="UTF-8"?> 宣告頭。

所有帶有 @_ 前綴的 JSON 欄位都會自動還原回對應的 XML 元素屬性,接著也能利用文字 Diff 比對工具於本地核對往返前後的結構差異。

將 JSON 無損序列化回格式化 XML

參考資料

常見問題

XML 中的 CDATA 區塊轉為 JSON 後會如何處理?

CDATA 包裝標記會解包為乾淨的 JSON 字串值,既不會遺失內部內容,也不會對 HTML 標籤或 & 符號造成重複跳脫。

XML 轉 JSON 時如何避免郵遞區號或編號的前導零消失?

關閉「解析標籤值(parseTagValue)」選項,像是 02139 這類純數字文字便會以 JSON 字串原樣保留,而不會被轉成數字 2139。

JSON 轉 XML 能把轉換出的 @_ 屬性還原成 XML 標籤屬性嗎?

可以。JSON 物件中所有以 @_ 開頭的屬性鍵在序列化時都會自動寫回父層 XML 標籤的屬性位置。

相關格式

相關方案比較

相關指南