CSV / Excel ⇄ JSON
表格匯入 · JSON 匯出 · 表頭識別
CSV / Excel
就緒
ABOUT
關於 CSV / Excel ⇄ JSON
將 CSV 或 Excel 表格轉為 JSON 陣列，或將 JSON 匯出為 CSV，方便資料匯入匯出。
運營、銷售、財務提供的 Excel 往往是介面聯調的第一手「真實資料」。本地解析避免將客戶名單、訂單明細上傳到第三方轉換網站，合規團隊也會更放心。
DEEP DIVE
深入瞭解 CSV / Excel ⇄ JSON
CSV 與 Excel 是業務人員最熟悉的資料格式，而 API 與資料庫通常消費 JSON。JSONSort CSV/Excel 工具支援表格與 JSON 陣列雙向轉換，表頭自動對映為 JSON 鍵名，適合快速將運營提供的表格變為程式可讀結構。
Excel .xlsx 檔案可在瀏覽器本地解析，無需上傳到雲端表格服務，保護業務資料隱私。
CSV 沒有統一標準：分隔符可能是逗號、分號或 Tab；引號規則在 Excel 匯出與 Unix cut 之間也不盡相同。匯入後務必預覽前幾行 JSON，確認列名與型別符合預期再寫入指令碼或資料庫。
FEATURES
核心能力
CSV → JSON
首行作為表頭，每行轉為 JSON 物件，組成陣列輸出。
JSON → CSV
JSON 陣列扁平化為表格，方便匯出給非技術人員。
Excel 匯入
支援 .xlsx / .xls 檔案拖拽匯入解析。
分隔符識別
自動處理逗號、製表符等常見 CSV 分隔符。
即時預覽
貼上 CSV 後立即看到 JSON 陣列結構。
本地解析
表格資料不上傳，適合含客戶資訊的業務表格。
型別推斷
數字、布林字串自動識別，減少下游 parseInt 工作。
JSON 扁平匯出
巢狀 JSON 陣列可匯出為扁平 CSV 供 Excel 開啟。
HOW TO USE
使用步驟
-
1
貼上 CSV 或上傳 .xlsx 檔案
-
2
確認表頭與分隔符
-
3
複製 JSON 或匯出 CSV
-
4
轉換失敗時檢視錯誤提示，修正原始檔語法後重試
-
5
結果可用格式化工具美化，或匯出供下游指令碼使用
WORKFLOW
典型工作流
從匯入資料到匯出結果的完整流程，幫助團隊統一 CSV / Excel ⇄ JSON 的使用方式。
準備表格
Excel 另存 CSV UTF-8，或直接拖拽 .xlsx 檔案。
預覽 JSON
檢查首條記錄的鍵名與值型別是否正確。
清洗（可選）
用合併清理去除空列，或格式化便於閱讀。
匯入下游
複製 JSON 到 Postman、指令碼或 Mock 工具。
USE CASES
適用場景
資料工程
運營 Excel 匯出轉 JSON 匯入 ETL 流水線。
後端開發
批次匯入 CSV 使用者資料，預覽 JSON 結構後寫入庫指令碼。
前端開發
產品給的 CSV 樣例轉 JSON 作為 Mock 資料來源。
測試工程師
測試用例 CSV 轉 JSON 驅動自動化測試框架。
增長運營
活動報名 Excel 轉 JSON 匯入營銷自動化系統。
財務對賬
銀行 CSV 流水轉 JSON 對接內部對賬 API。
TIPS
使用技巧
- CSV 首行必須是表頭，否則鍵名會變成 col1、col2 等預設名。
- 欄位含逗號時需用雙引號包裹，否則會被錯誤分列。
- Excel 多 sheet 檔案當前解析第一個 sheet，可預先匯出目標 sheet。
- JSON → CSV 適合將 API 返回的陣列匯出給產品/運營檢視。
- 轉換後用格式化工具檢查，確認數字未被誤解析為字串。
- 大表格建議先取前幾行驗證列對映，再處理完整檔案。
- Windows Excel 匯出 CSV 可能是 GBK，建議另存 UTF-8 再匯入。
- 日期列常被識別為字串，下游需按 locale 解析。
- 空行會被跳過；全空行分隔的區塊可能需手動清理。
- JSON 陣列過大時匯出 CSV 注意 Excel 104 萬行上限。
LOCAL VS ONLINE
本地 vs 線上工具
JSONSort 堅持純前端架構，以下對比說明為何本地化工具更適合處理開發資料。
TROUBLESHOOTING
常見誤區與排查
實際使用中容易遇到的問題及建議處理方式，減少反覆試錯的時間。
列錯位
建議：欄位內逗號未用雙引號包裹；回到 Excel 修正或手動加引號。
中文亂碼
建議：確認檔案 UTF-8 編碼；Excel 匯入時選 UTF-8 CSV。
數字變字串
建議：前導零或過長數字會保留字串，下游顯式轉換型別。
多 sheet 不對
建議：當前解析首個 sheet；請預先匯出目標 sheet。
FAQ
常見問題
Excel 公式單元格怎麼處理？
讀取單元格的顯示值（計算結果），而非公式本身。
空單元格會變成什麼？
通常轉為空字串 "" 或 null，取決於列型別推斷。
支援 UTF-8 BOM 的 CSV 嗎？
支援。BOM 頭會自動識別並正確處理中文內容。
能指定自定義分隔符嗎？
自動識別常見分隔符。若失敗可先將 Tab 轉為逗號再貼上。
表頭可以不要嗎？
無表頭時會生成 col1、col2 等預設列名，建議始終提供表頭行。
資料會上傳到伺服器嗎？
不會。JSONSort 所有工具均在瀏覽器本地執行，您的輸入內容不會傳送到任何後端伺服器。
需要註冊或安裝嗎？
不需要。開啟頁面即可使用，無需賬號、無需下載客戶端，也支援 PWA 離線快取。
支援多大的檔案？
取決於瀏覽器記憶體，通常可流暢處理數 MB 級別的資料。超大檔案建議先拆分或使用合併清理工具。