文字與資料

JSON 轉 CSV

將扁平 JSON 轉為 CSV 表格,匯入前先檢查。

如何使用此工具

  1. 1

    貼上有效的 JSON,內容應為扁平物件陣列,或各列等長且只包含簡單值的陣列。

  2. 2

    選擇逗號、定位字元或分號作為分隔字元,檢查公式防護設定,並在 1 MB、10,000 列和 200 欄的限制內轉換。

  3. 3

    檢查 CSV,尤其是空儲存格和以公式字元開頭的值,然後複製或下載。

將由扁平 JSON 紀錄組成的陣列,或各列等長的矩形陣列轉為 CSV。工具會拒絕巢狀物件和陣列,不會悄悄將它們展開。對於可能在試算表中開啟的匯出檔案,預設開啟公式防護。

從適合表格的資料開始

扁平紀錄包含具名欄位,其值可以放入單個儲存格,例如名稱、代碼或數量。由這些紀錄組成的陣列可以轉換為表格。矩形陣列則直接提供儲存格數量相同的各列。由於這些結構的列與欄的關係明確,因此工具支援它們。

記錄中如果包含地址物件或標籤陣列,就是巢狀資料。本工具會拒絕巢狀值。轉換前,請先決定如何將它們表示為欄:地址可能需要拆成城市和郵遞區號欄位,標籤清單也需要明確的表示方式。自動攤平可能會掩蓋這一步的重要選擇。

範例:匯出庫存清單

假設扁平紀錄包含代碼、名稱和數量。請將 00127 這類產品代碼保留為 JSON 字串,使前置零仍存在於 CSV 文字中。「馬克杯, 藍色」這樣的名稱會放在帶引號的 CSV 欄位裡,避免英文逗號分隔出額外的一欄。

在試算表中開啟結果前,請透過匯入選項把編碼欄設為文字。轉換器可以保留 CSV 中的字元,但試算表仍可能將其解讀為數字。請檢查匯入後的編碼,不要假定預覽與試算表中的顯示始終一致。

理解公式保護

試算表應用程式可能將某些開頭字元解讀為公式的起始符號。預設啟用公式保護,有助於讓這類匯出儲存格保持文字形式。當表格包含以 =、+、- 或 @ 等字元開頭的值時,請檢查此設定,尤其是在資料來自他人的情況下。

保護措施可能有意改變儲存格在 CSV 中的表示形式。如果可信的下游系統需要完全一致的文字,請先檢查輸出並了解該系統的處理方式,再關閉保護。為包含逗號的 CSV 欄位加引號是另一項操作;普通 CSV 引號本身並不能保證公式安全。

排查無效 JSON 和列長度不一致

JSON 的屬性名稱和字串值必須使用雙引號。註解和結尾多餘的逗號都不符合 JSON 語法。剖析失敗時,請檢查工具報告的位置,修正輸入後再試。從原始碼複製的 JavaScript 物件不一定是有效的 JSON 文字。

對於二維列陣列,每列必須包含相同數量的儲存格。對於巢狀記錄,請先在來源系統中選出所需的欄。匯出內容須不超過 1 MB、10,000 列和 200 欄,並保留原始 JSON,以便在匯入 CSV 後對照檢查。

保護長識別碼和高精度小數

轉換前會檢查 JSON 數字。如果數值在 JavaScript 中表示時會發生變化、整數超出安全整數範圍、發生溢位,或非零值會被捨入為零,工具就會拒絕轉換。例如,要完整保留識別碼 1234567890123456789 的每一位,應將它寫成帶引號的 JSON 字串。對精度敏感的小數也應使用字串。普通小數和科學記號只要通過此檢查、十進位數值不變,就可以使用。

常見問題

巢狀物件會被轉為文字儲存格嗎?

不會。工具會拒絕巢狀物件和陣列。請在轉換前視需要要自行展開資料,以便明確控制欄名和值的含義。

CSV 會保留 JSON 類型嗎?

CSV 是由文字欄位組成的表格,無法保留完整的 JSON 類型定義。請確認接收應用程式在匯入時如何解釋數字、空儲存格及其他值。

資料在哪裡處理?

轉換直接在瀏覽器中完成,不上傳輸入內容。離開頁面前請下載或複製結果,並在匯入完整表格前,在目標應用程式中檢查一份樣本。

參考資料與延伸閱讀