· 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 就是按這種形狀來的。
巢狀物件 → 帶字首的欄
值本身還是物件時,把內部鍵抬升成欄。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
很深的樹、遞迴子節點、每條記錄結構都不同的檔案,不適合整份攤成一張表。只抽出要進表格的那一層,或按實體拆成多個工作表。
反過來從 CSV 回到 JSON 時,值都會變成字串,需要的話在程式碼裡自己轉型。