CSV 轉 JSONL 轉換器

如何將 CSV 轉換為 JSONL

CSV 轉 JSONL 轉換會讀取 CSV 檔案的第一列作為欄位標頭，然後將後續每一列轉換為以這些標頭為鍵值的 JSON 物件。

我們的轉換器會自動偵測分隔符號（逗號、Tab 或分號），並處理帶引號的欄位，包括包含逗號或換行符的欄位。值會自動進行類型推斷——數字、布林值和 null 都會被偵測到。

輸出為有效的 JSONL 格式，每行一個緊湊的 JSON 物件，可直接用於機器學習平台、資料管線和 API。

型別推斷規則

CSV 儲存格只是文字；要把它變成有用的 JSON，就得猜測型別。此轉換器遵循以下規則 — 並在猜測可能破壞資料時，告訴你如何覆寫：

數字 → number

像 42 或 3.14 這樣的儲存格會變成 JSON 數字。陷阱在於：看起來像數字但其實不是的值 — 美國郵遞區號 00501 會因為變成數字 501 而失去前導零。任何前導零或精確文字很重要的值，都應該在來源中保持引號包裹，或維持為字串欄位。

true/false → boolean

不分大小寫的 true 和 false 會變成 JSON 布林值。字串 yes、no、0 和 1 則保持不動 — 對這些值猜測意圖造成的錯誤，比它能解決的還多。

空儲存格 → null

空儲存格會變成 JSON null 而不是空字串 — 下游程式碼就能用簡單的 null 檢查，而不用判斷是否為 ""。

引號欄位、逗號與內嵌換行

標準 CSV 引號規則會被遵守：引號包裹的欄位可以包含逗號甚至換行，成對的雙引號（""）會還原成一個引號字元。含內嵌換行的欄位仍然會變成單一 JSONL 行 — 換行在 JSON 字串中會被轉義為 \n。

常見錯誤與解決方案

什麼是 CSV 轉 JSONL 轉換？

CSV 轉 JSONL 轉換將試算表和資料庫中的表格資料轉換為 JSON Lines 格式。CSV 的每一列會成為單獨的 JSON 物件，各佔一行，欄位標頭用作鍵值名稱。

這種轉換對於將試算表資料準備用於機器學習訓練（OpenAI、Hugging Face）、將資料載入 NoSQL 資料庫，以及將結構化資料輸入串流管線至關重要。

用 pandas 做同樣的轉換

如果你的 CSV 已經在 Python 管線中，pandas 用兩個呼叫就能完成這個轉換 — 而且它的 dtype 推斷與上面描述的直覺一致：

import pandas as pd

df = pd.read_csv('input.csv', dtype={'zip': 'string'})  # protect ZIP codes
df.to_json('output.jsonl', orient='records', lines=True, force_ascii=False)

dtype 引數就是 pandas 版的前導零規則：明確把脆弱欄位宣告為字串，而不是信任自動推斷。force_ascii=False 讓非 ASCII 文字保持可讀，而不是被 \u 轉義。

常見問題