JSON 轉 CSV 轉換器

JSON 轉 CSV 轉換器

歡迎使用 JSON 轉 CSV 轉換器，這是一個免費的線上工具，能將任何 JSON 有效負載（扁平陣列、嵌套對象、深層包裝的 API 回應）扁平化為整齊、可直接用於試算表的 CSV。大多數線上轉換器只能處理根目錄下的簡單 [{...}, {...}] 情況，當您的 JSON 形如 {"data": {"items": [...]}} 時就會失效。此工具能智慧自動偵測表格陣列，提供 JSONPath 風格的選取器來處理特殊結構，並提供兩種扁平化模式（點號和括號）以及結構預覽，讓您在下載之前確切了解試算表中的列分布。

JSON 轉 CSV 轉換器的用途是什麼？

JSON 是 Web API 和現代數據管道的通用語言，而 CSV 仍是試算表、商業智慧 (BI) 儀表板和數據分析工具的首選。將兩者互相轉換是數據工程師日常工作中最常見的任務之一。典型的應用場景包括將 API 回應匯出到 Excel 以供利害關係人查看、準備 JSON 轉儲以匯入 Postgres 或 BigQuery、將 JSON 日誌饋送到 Pandas 或 R 進行分析，以及以更友好的表格形式快速瀏覽雜亂的嵌套回應。

核心功能

• 智慧陣列自動偵測： 轉換器會掃描您的 JSON 並選取最大、最像表格的陣列——通常這就是您真正想要的數據。
• JSONPath 選取器： 使用 data.users 或 results[0].rows 等路徑覆蓋自動偵測，深入提取包裝好的回應。
• 兩種扁平化模式： 點號標記法 (address.city) 用於簡潔的欄位名稱，或括號陣列 (tags[0], tags[1]) 用於將每個元素展開為獨立欄位。
• 結構探索： 帶有類型徽章（字串、整數、數字、布林值、混合）的欄位標籤面板，讓您在下載前審核輸出內容。
• 即時預覽表格： 前八列會渲染為 HTML 表格——即時驗證您的數據是否對齊正確。
• 自定義分隔符： 逗號 (CSV)、分號 (歐洲 Excel)、製表符 (TSV)、管道符或您指定的任何單個字元。
• 引號模式： 最小化 (RFC 4180)、全引號、非數字引號或不使用引號（使用反斜線轉義）。
• Excel 友好換行符： 可在 LF 和 CRLF 之間切換。
• 可選標題列。
• 一鍵範例： 包含扁平陣列、包裝回應、嵌套對象、GitHub 風格 API 和天氣預報。
• 複製與下載： 立即獲取 CSV 或將其儲存為 .csv 文件。

轉換器如何處理嵌套對象和陣列？

現實世界中的 JSON 很少是完全扁平的。本工具的扁平化引擎能夠智慧地處理兩種主要結構：

嵌套對象 → 點號標記法

對象內部的對象會轉換為帶點號的欄位名稱。因此，像 {"id": 1, "address": {"city": "Tokyo", "zip": "100-0001"}} 這樣的記錄會產生三個欄位：id、address.city、address.zip。這種慣例被 Pandas json_normalize、Splunk、Elasticsearch 和許多其他工具所採用——您的下游管道將能直接理解它。

嵌套陣列 → 兩種策略

純量陣列（例如 "tags": ["red", "blue"]）和對象陣列（例如 "orders": [{...}, {...}]）根據所選的扁平化模式會得到不同的處理：

• 點號模式： 純量陣列會在單個單元格中以管道符連接 (red|blue)；對象陣列則進行 JSON 編碼，確保數據不丟失。這能保持欄位數量可預測。
• 括號模式： 每個元素都會獲得自己的索引欄位——tags[0]、tags[1]、orders[0].id、orders[0].total。最適合記錄中包含已知固定長度陣列的情況。
• 保留嵌套為 JSON： 嵌套結構會序列化為 JSON 字串並插入單個單元格。當目標試算表具備 JSON 感知欄位或您想保留原始形狀時非常有用。

JSONPath 選取器有什麼用？

大多數公開 API 會將數據包裝在額外的元數據中：狀態碼、分頁資訊、請求 ID。典型的回應如下：

自動偵測通常會找到內部的陣列，但對於異常或深層嵌套的結構，您可以顯式提供路徑。選取器支援點號鍵名和括號數字索引：

• data — 進入 data 鍵名
• data.users — 進入 data，然後是 users
• results[0].rows — 進入 results 的第一個項目，然後是其 rows 鍵名
• (空白) — 自動偵測最像表格的陣列

它會生成 Excel 相容的 CSV 嗎？

是的。預設設定（逗號分隔符、最小引號、標題列、LF 換行符）會產生嚴格的 RFC 4180 輸出，可在 Excel、Google Sheets、Numbers、LibreOffice Calc、Pandas read_csv、R read.csv 以及每個資料庫的 COPY FROM 指令中正常開啟。對於使用分號作為欄位分隔符的歐洲 Excel 地區，請將分隔符下拉選單切換至 Semicolon。對於偏好 \r\n 換行符的 Windows 原生工具，請將換行符切換至 CRLF。

如何處理跨行缺失的欄位？

JSON 陣列通常包含異質記錄——一個對象有 middle_name，下一個則沒有。轉換器會遍歷每條記錄並按首次見到的順序收集欄位名稱；任何缺少該欄位的記錄在該位置都會獲得一個空單元格。這與 Pandas json_normalize 的行為一致，避免了靜默丟棄僅出現在某些記錄中的欄位。

實際應用場景

對於開發人員

• 將 REST API 回應轉換為 CSV，以便在試算表中進行探索
• 扁平化 MongoDB 或 Firestore 匯出數據，以便匯入關聯式資料庫
• 將 JSON 日誌行轉化為表格格式進行分析
• 結合範例 JSON 與括號模式輸出，生成測試固件 (Test Fixtures)

對於數據分析師與科學家

• 無需編寫 Pandas 腳本，即可快速預覽表格形式的 API 數據
• 準備網頁爬取的 JSON 數據，以便匯入 Excel、Tableau 或 Power BI
• 將 JSON 數據集轉換為 CSV，用於 Jupyter 或 RStudio
• 在實際匯入前，使用結構探索面板審核嵌套欄位

對於行銷人員與營運人員

• 將 JSON 產出工具（分析、CRM 匯出）中的數據匯出至 Google Sheets
• 基於 JSON API 輸出建立樞紐分析表或圖表
• 將友好的 CSV 交給非技術利害關係人，而無需向他們展示原始 JSON

如何使用此工具

1. 貼上 JSON： 將您的 JSON 貼入輸入框，或點擊快速範例標籤載入典型的 API 有效負載。
2. 選取陣列： 保持 JSONPath 欄位空白讓工具自動偵測表格陣列，或輸入路徑如 data.users 來指定包裝陣列。
3. 選擇扁平化模式： 選擇點號標記法以獲得簡潔的列名，選擇括號陣列以展開每個陣列元素，或選擇保留嵌套為 JSON 以原樣保留子結構。
4. 選擇分隔符與引號： 選擇逗號、分號、製表符 (TSV)、管道符或自定義字元，然後選擇引號模式和換行符。
5. 轉換與檢查： 點擊轉換為 CSV。檢查結構面板和預覽表，然後複製結果或將其下載為 .csv 文件。

獲得最佳結果的提示

• 先驗證： 輸入框下方的即時指示器會在您點擊轉換前標出 JSON 語法錯誤。
• 檢查結構面板： 標記為 mixed 的欄位意味著同一欄位在不同記錄中具有不同類型——這通常是上游攝取錯誤需要修復的信號。
• 針對固定陣列使用括號模式： 如果每條記錄都有（例如）正好四個分數，括號模式會提供四個整齊的欄位，而不是單個以管道符連接的單元格。
• 針對歐洲版 Excel： 選擇 Semicolon 分隔符，這樣 1,5（一點五）就不會被拆分成兩個單元格。
• 針對 Windows 版 Excel： 選擇 CRLF 換行符，以避免所有數據都擠在 A 欄的問題。
• 安全起見引用一切： 如果您的數據包含逗號、換行符或您的分隔符字元，建議使用 為所有欄位加上引號 以獲得最穩妥的輸出。

常見問題解答

如果我的 JSON 有多個陣列會怎樣？

自動偵測會選取包含對象的最長陣列。如果那不是您想要的陣列，請提供 JSONPath（如 orders 或 line_items）來定位正確的陣列。

我可以轉換單個 JSON 對象而不是陣列嗎？

可以——單個對象會變成一行 CSV，每個頂層欄位作為一列。扁平化規則仍然適用。

如何處理帶有非有限數字（NaN, Infinity）的 JSON？

標準 JSON 不允許這些字面量，但如果您的輸入包含它們並成功解析，它們將在 CSV 輸出中被轉換為空單元格，以保持文件有效性。

為什麼有些布林值顯示為 true / false？

這是為了保持 CSV 的可讀性。如果您的下游工具需要 1 / 0，請在下載後進行搜尋取代，或預先處理 JSON。

轉換器會驗證所有記錄是否具有相同的形狀嗎？

不會——異質記錄會被妥善處理（缺失欄位變為空單元格）。結構面板會透過 mixed 徽章顯示類型偏移，以便您發現不一致之處。

我可以轉換多大的 JSON？

此工具在瀏覽器和伺服器上都能輕鬆處理高達數 MB 的 JSON 輸入。對於極大的數據集（數十 MB 或更多），建議使用離線串流工具如 jq 或帶有 ijson 的 Python 腳本。

我的數據會被發送到伺服器嗎？

轉換在 MiniWebtool 伺服器上執行，以利用 Python 強大的 CSV 寫入器和 JSON 解析器。我們不會記錄、存儲或分享您的輸入。回應不含快取標頭。對於具有敏感數據的極高機密需求，建議使用離線處理。

額外資源

• 逗號分隔值 - 維基百科
• JSON - 維基百科
• RFC 4180 - CSV 文件格式 (英文)

其他相關工具:

其他文字工具:

• 相同字母異序詞生成器
• 仿生閱讀轉換器
• 比較兩個字串
• 找最長一行工具
• AI 語言偵測器
• 文本行處理器
• XML驗證器
• 文本轉語音閱讀器
• 文本列提取器
• JSON轉YAML轉換器
• 正規表達式測試器 新
• 文字差異比對工具 新
• CSV轉JSON轉換器 新
• 圖片Base64轉換器 新
• API測試工具 新
• ASCII碼表 新
• Webhook測試器 新
• AI部落格標題產生器 新
• AI 話題標籤產生器 新
• AI標語產生器 新
• AI文章大綱生成器 新
• 線上記事本 新
• TOML 轉 JSON 轉換器 新
• JSON 轉 CSV 轉換器 新
• XML轉JSON轉換器 新
• SQL到MongoDB查詢轉換器 新
• 漏字文檢測器 新
• 全字母句檢查器 新
• 首字母縮寫產生器 新
• 倒推首字母縮寫產生器 新
• 發音音標轉換器 新