.jsonl · application/x-ndjson
JSONL / NDJSON: JSON Lines / 換行分隔 JSON
JSONL(換行分隔 JSON)以 \n 分隔每行一個完整自足的單行 JSON 值,無須載入整份陣列即可逐行串流讀取。
快速解答: JSONL(換行分隔 JSON)以 \n 分隔每行一個完整自足的單行 JSON 值,無須載入整份陣列即可逐行串流讀取。 OpenAI/Anthropic/Gemini 模型微調資料集、批次推論工作、日誌擷取與串流 ETL。
| 結構類型 | 階層式 |
|---|---|
| 人類可讀性 | 中 |
| 支援巢狀結構 | 支援 |
| LLM Token 效率 | 中 |
| 副檔名 | .jsonl |
| MIME 類型 | application/x-ndjson |
| 最適合用於 | OpenAI/Anthropic/Gemini 模型微調資料集、批次推論工作、日誌擷取與串流 ETL。 |
核心優勢
- OpenAI、Claude 與 Vertex AI 模型微調及批次 API 的指定格式
- 無須解析外層 [ ... ] 包覆即可逐筆附加與串流處理
- 單筆記錄損毀僅影響該行,不會波及整份檔案的解析
限制與權衡
- 經過美化縮排的多行 JSON 物件無法作為單筆合法 JSONL 行
- 無法直接以單一裸 JSON.parse() 呼叫整份讀取
- 每筆記錄依然會重複寫出所有 JSON 欄位名稱
參考資料
在本機轉換與清理 JSONL / NDJSON
相關工程指南
相關格式
全部 24 種格式JSONL / NDJSON 常見問題
JSONL 與 NDJSON 是同一種格式嗎?
實務上是同一種格式。JSON Lines (.jsonl) 與 Newline-Delimited JSON (.ndjson) 皆採每行一筆精簡 UTF-8 JSON 物件並以 \n 分隔。
可以直接把 CSV 轉換為 OpenAI 對話微調 JSONL 嗎?
可以。CSV 轉 JSONL 內建原始物件、OpenAI Chat messages 陣列與 Alpaca instruction/input/output 範本。
為何微調平台上傳驗證常在空白結尾行或縮排 JSON 上失敗?
JSONL 規定每一行都必須是完整的單行 JSON 值。啟用逐行驗證即可在上傳前先找出異常列。