· CSV.ink Team

巢狀 JSON 怎麼轉成 CSV(欄位別丟)

扁平的物件陣列一步就能變成表。遇到巢狀物件和陣列,要先定規則再匯出,否則容易丟欄位或寫出 [object Object]。

JSON 喜歡巢狀,CSV 不喜歡。介面返回的客戶帶著 address 物件和 tags 陣列時,隨便轉一版要麼丟欄位,要麼格子裡出現 [object Object]。匯出前要先定攤平規則。

先從「結構差不多的物件列表」開始

CSV 是一張表:一列表頭,後面每列欄數相同。最省事的是 JSON 陣列裡每個元素都是鍵大致相同的物件:

[
  {"id": 1, "name": "Ada", "city": "London"},
  {"id": 2, "name": "Lin", "city": "Taipei"}
]

這可以直接變成兩列資料。我們的 JSON 轉 CSV 就是按這種形狀來的。

JSON 轉 CSV →

巢狀物件 → 帶字首的欄

值本身還是物件時,把內部鍵抬升成欄。address.city、address.zip 後面篩選比整格塞一段 JSON 好用。

{
  "id": 1,
  "name": "Ada",
  "address": {"city": "London", "zip": "E1 6AN"}
}

→ id,name,address.city,address.zip
   1,Ada,London,E1 6AN

兩個巢狀物件有同名鍵時,保留字首,避免欄名撞車。

陣列 → 拼接、擴列或保留原文

列表塞不進一個乾淨儲存格。整份檔案選一種策略並堅持:

  • 拼接:tags 寫成 "a, b, c"。好看;標籤裡自己帶逗號就麻煩。
  • 擴列:列表每一項一列,父欄位重複。適合分析;列數會變多。
  • 丟掉,或整欄保留原始 JSON,只給下一個程式讀。

空值和型別

缺的鍵匯出成空儲存格,不要預設寫成字串 "null"(除非下游就認這個詞)。編號、郵編若怕丟前導零,在 CSV 裡當文字處理——Excel 一開啟型別可能又變。

什麼時候別硬轉 CSV

很深的樹、遞迴子節點、每條記錄結構都不同的檔案,不適合整份攤成一張表。只抽出要進表格的那一層,或按實體拆成多個工作表。

JSON 轉 Excel(可多表) →

反過來從 CSV 回到 JSON 時,值都會變成字串,需要的話在程式碼裡自己轉型。

CSV 轉 JSON →

相關工具

← 全部文章

更多文章