JSON to CSV Converter

JSON 與 CSV 是兩種完全不同用途的資料格式：

• JSON（JavaScript Object Notation）是一種結構化資料格式，支援巢狀物件與陣列，適合程式間資料交換與 API 通訊。
• CSV（Comma-Separated Values）是一種純文字表格格式，每行代表一筆記錄，每列代表一個欄位，是 Excel、Google Sheets、資料庫匯入匯出的通用格式。

以下情況適合將 JSON 轉為 CSV：

• 需要將 API 資料匯入 Excel 或 Google Sheets 進行分析
• 準備資料集進行機器學習或統計分析
• 與非技術人員共享結構化資料（CSV 可直接用 Excel 開啟）
• 將資料匯入資料庫（MySQL、PostgreSQL 支援 CSV 匯入）
• 產生報表或試算表供決策者檢視

CSV 是二維表格格式（行 × 列），無法直接表示巢狀結構。本工具使用 點記法（Dot Notation）展平技術，自動將巢狀物件轉為平面欄位：

{
  "user": {
    "name": "Gary",
    "age": 30
  }
}

user.name,user.age
Gary,30

展平規則：

• 物件 → 遞迴展平，Key 以點串接，例如 profile.address.city
• 陣列 → 保留為 JSON 字串存入單一儲存格，避免欄位爆炸
• Null → 依空值設定處理（空字串 / null / N/A / 0）

展平發生時，工具頂部會顯示橙色提示：「巢狀 JSON 已自動展平」。

將 CSV 匯入 Excel 有幾種方法：

1. 直接開啟：下載 .csv 檔案後，直接用 Excel 開啟（選擇 UTF-8 編碼）
2. 從資料匯入：Excel → 資料 → 從文字/CSV 匯入 → 選擇檔案 → 指定分隔符與編碼
3. 拖曳到 Google Sheets：直接將 .csv 檔案拖入 Google Sheets 即可自動解析

UTF-8 BOM 是什麼？

BOM（Byte Order Mark）是位於檔案開頭的  標記。對於 CSV 檔案：

• 啟用 BOM → Excel 會自動識別為 UTF-8 編碼，正確顯示中文、日文等 Unicode 字符
• 無 BOM → Excel 可能以系統預設編碼（如 Big5）開啟，導致亂碼

💡 如果將 CSV 匯入 Excel 後中文顯示亂碼，請啟用「UTF-8 BOM」選項重新下載。

CSV 中的「C」代表 Comma（逗號），但實際上 CSV 可以使用不同的分隔符：

• 逗號（,） — 最通用的標準，Excel 與 Google Sheets 的預設值。但如果資料中包含逗號（如地址「台北市, 台灣」），必須使用引號包裹。
• 分號（;） — 部分歐洲地區 Excel 的預設分隔符（因逗號用作小數點）。如果你的 CSV 在 Excel 中無法正確分欄，試試分號。
• Tab（\t） — 又稱為 TSV（Tab-Separated Values）。如果資料中頻繁出現逗號與分號，Tab 是最安全的選擇。許多資料庫匯入工具優先支援 TSV。

💡 不確定該用哪種？先用逗號，如果 Excel 顯示不正常，改用分號試試。

以下是最常見的幾種問題與解決方案：

• 巢狀物件資料不見了？ 本工具會自動展平巢狀 JSON（如 profile.age），但如果 JSON 結構過於複雜（如深層巢狀超過 5 層），建議先簡化資料再轉換。
• 陣列資料被截斷？ 陣列欄位會以 JSON 字串形式保留在單一儲存格中（如 "["a","b","c"]"），匯入 Excel 後可能無法自動展開。您可以在 Excel 中使用「資料 → 從表格/範圍」進一步處理。
• 中文字元變成亂碼？ 啟用「UTF-8 BOM」選項後重新下載，Excel 將正確識別 UTF-8 編碼。
• CSV 在 Excel 中全部擠在同一欄？ 改用「分號（;）」或「Tab（\t）」作為分隔符，或在 Excel 匯入時手動指定分隔符。

100% 安全。本工具採用純前端（Client-side）架構，所有 JSON 解析與 CSV 轉換都在您的瀏覽器中完成，不會將任何資料上傳至任何伺服器。

這意味著：

• 您的客戶資料、API 回應、商業機密絕不會離開您的電腦
• 不需要網路連線即可執行轉換（除了第一次載入頁面）
• 沒有任何後端伺服器會儲存或處理您的內容
• 即使是 ToolHub 的管理者也無法存取您輸入的資料

無論是分析客戶名單、處理財務資料或轉換機密 API 回應，在這裡操作都是安全的。