.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

相關工程指南

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 值。啟用逐行驗證即可在上傳前先找出異常列。