JSON 扁平化轉 JSONL
擷取並扁平化巢狀 JSON 物件和陣列為 JSONL(JSON Lines)格式。每筆記錄成為獨立的一行。100% 在用戶端處理。
輸入 JSON
將 .json 檔案拖放到這裡,或點擊瀏覽
支援 .json、.txt
輸出 JSONL
貼上或拖放巢狀 JSON 以扁平化為 JSONL
什麼是 JSON 扁平化?
JSON 扁平化是將深度巢狀的 JSON 結構轉換為扁平的逐行格式的過程。巢狀物件鍵值會轉換為點號表示法(例如 address.city),物件陣列會展開,使每個元素成為 JSONL 格式中的獨立記錄。
當您有來自 API 回應或資料庫匯出的複雜巢狀結構,需要將它們轉換為扁平的表格格式以用於機器學習訓練、CSV 轉換,或期望每行一筆記錄的串流資料管線時,這特別有用。
攤平陣列的兩種方式 — 依目的地選擇
巢狀物件的攤平方式很直觀(用點連接鍵名),但陣列就得做真正的抉擇。正確的策略取決於攤平後的資料要送去哪裡:
| 策略 | [{"sku":"A"},{"sku":"B"}] 會變成 | 適用時機 |
|---|---|---|
| 索引展開 | items.0.sku = A、items.1.sku = B — 一列,更多欄 | 列數必須與輸入完全一致;陣列短且長度有上限 |
| 展開成多列 | 兩列,各含 items.sku — 更多列,欄位穩定 | 餵給 SQL 或分析系統,且每個陣列元素其實就是一筆獨立記錄 |
| 保留為 JSON 字串 | items = "[{\"sku\":\"A\"},...]" — 一個不透明的儲存格 | 陣列是之後才會重新解析的中繼資料,不是現在要查詢的資料 |
如何將 JSON 扁平化為 JSONL
將 JSON 扁平化為 JSONL 會從巢狀結構中擷取記錄,並將每筆記錄轉換為獨立的 JSONL 行。如果您的 JSON 包含物件陣列,每個陣列元素會成為一行。巢狀物件鍵值會扁平化為點號表示法。
我們的工具完全在您的瀏覽器中運作。不會將任何資料傳送到任何伺服器。貼上您的巢狀 JSON 或拖放檔案,扁平化的 JSONL 輸出會立即出現。父層級欄位會自動合併到每筆記錄中。
輸出為有效的 JSONL,每行一個緊湊的 JSON 物件。您可以將結果複製到剪貼簿,或下載為 .jsonl 檔案,準備用於機器學習、資料管線或資料庫匯入。
攤平前後對照
一筆真實的巢狀記錄與其索引展開後的扁平形式。注意分隔符的選擇很重要:使用點的話,來源中像 "config.debug" 這樣本身含點的鍵,會與攤平後的路徑 config.debug 衝突 — 如果你的鍵含有點,請把分隔符改成底線:
// Before — nested record:
{"user": {"id": 7, "address": {"city": "Osaka", "zip": "530-0001"}}, "tags": ["vip", "beta"]}
// After — flattened with dot separator, arrays index-expanded:
{"user.id": 7, "user.address.city": "Osaka", "user.address.zip": "530-0001", "tags.0": "vip", "tags.1": "beta"}攤平是匯出成 CSV 或 Excel 前的標準前處理步驟 — 這些格式是表格式的,無法表示巢狀結構。巢狀很深的輸入可能產生非常寬的輸出,所以請先攤平一份樣本、確認欄位數量合理,再處理完整檔案。
常見使用情境
- API 回應處理
- 將巢狀 API 回應扁平化為 JSONL,以便在資料管線中更輕鬆地解析、記錄和下游處理。
- ETL 資料轉換
- 從複雜的 JSON 匯出中擷取記錄,並將它們扁平化為 JSONL,以載入到資料庫或資料倉儲。
- 機器學習資料集準備
- 將巢狀 JSON 資料集轉換為 OpenAI、Hugging Face 和其他機器學習訓練平台所需的扁平 JSONL 記錄。
- 日誌與分析處理
- 將帶有巢狀中繼資料的結構化日誌檔案扁平化為 JSONL,以使用 grep、jq 或 Elasticsearch 等工具進行分析。
- 測試資料生成
- 將複雜的 JSON API 模擬回應扁平化為個別的 JSONL 記錄,作為自動化測試套件中的測試資料使用。
- 資料庫遷移
- 將 MongoDB 或 CouchDB 匯出的巢狀文件式 JSON 扁平化為扁平的 JSONL 記錄,以匯入 PostgreSQL 等關聯式資料庫。
常見錯誤與解決方案
找不到要扁平化的記錄
當輸入的 JSON 是基本值(字串、數字)或空物件/陣列時會出現此錯誤。工具需要物件或物件陣列來擷取記錄。請確保您的 JSON 至少包含一個具有鍵值對的物件。
點號表示法鍵值衝突
如果您的 JSON 在頂層有像 "user.name" 這樣的鍵值,同時又有巢狀的 {"user":{"name":"value"}},兩者會扁平化為相同的點號表示法鍵值。巢狀值會覆蓋頂層值。請在扁平化前重新命名衝突的鍵值。
JSON 中的循環參考
雖然標準 JSON 不能包含循環參考,但某些 JSON 生成器可能會產生非常深度巢狀的結構。工具可以處理合理深度的巢狀,但如果結構超出安全限制,將停止扁平化。
常見問題
巢狀物件是如何扁平化的?
巢狀物件鍵值會轉換為點號表示法。例如,{"user":{"address":{"city":"NYC"}}} 會變成 {"user.address.city":"NYC"}。這使得深度巢狀的資料可以作為扁平的鍵值對存取。
扁平化時會如何處理 JSON 中的陣列?
如果 JSON 包含物件陣列,每個物件會成為獨立的 JSONL 行。基本類型陣列(字串、數字)會在扁平化輸出中序列化為 JSON 字串。工具會自動偵測要展開的主陣列。
扁平化時,我的資料安全嗎?
是的。所有扁平化都在您的瀏覽器本機進行。不會將任何資料傳送到任何伺服器。您的 JSON 內容永遠不會離開您的裝置。
JSON 中有不同深度的巢狀結構,也能扁平化嗎?
可以。工具可以處理任何層級的巢狀。頂層純量欄位會合併到每筆記錄中,巢狀物件使用點號表示法,最大的物件陣列會展開為獨立的 JSONL 行。
扁平化時會如何處理 null 和 undefined 值?
null 值會在扁平化輸出中保留為 null。JSON 沒有 undefined 類型,因此您不會遇到 undefined 值。空物件扁平化後不會產生任何鍵值,空陣列則序列化為空的 JSON 陣列。
可以一次將多個 JSON 檔案扁平化嗎?
目前工具一次處理一個 JSON 輸入。如需扁平化多個檔案,請逐一處理。對於批次操作,可以考慮搭配使用 jq 等命令列工具,再用本工具進行視覺化驗證。
這個工具最多支援幾層巢狀結構?
工具支援真實世界 JSON 資料中常見的巢狀深度(通常超過 20 層)。沒有硬性的深度限制,但極深的巢狀可能會在輸出中產生非常長的點號表示法鍵值。
這個工具和一般的 JSON 轉 JSONL 有什麼差別?
JSON 轉 JSONL 僅將頂層陣列的每個元素放在單獨的一行上。JSON 扁平化轉 JSONL 則更進一步,會展開巢狀結構、將巢狀鍵值轉換為點號表示法,並將父層級欄位合併到每筆記錄中。當您需要從深度巢狀的 JSON 中擷取記錄時,請使用扁平化功能。
相關工具與指南
將 JSON 陣列轉換為 JSONL 格式。非常適合為串流和 ML 訓練準備資料。
將 JSONL 資料匯出為 CSV 試算表。非常適合在 Excel 或 Google Sheets 中進行分析。
將 JSONL 資料轉換為 Excel 原生格式(.xlsx)的試算表,適合製作業務報表、分析資料,以及與非技術背景的相關人員分享。
逐行驗證 JSONL 檔案。即時捕獲語法錯誤、編碼問題和格式問題。
處理 GB 級 JSONL 資料的策略。串流讀取、記憶體管理、檔案分割、壓縮及線上工具。