JSONL / NDJSON 完全指南:JSON 互转、逐行校验与格式化(免费在线)
🔍 为什么你需要一个 JSONL 转换工具
处理日志、数据导入或大模型微调数据集时,你大概率见过这种文件:没有外层方括号,没有记录之间的逗号,每行就是一条独立的 JSON。这就是 JSONL(JSON Lines),也叫 NDJSON(Newline Delimited JSON)。
麻烦通常出在格式不匹配:平台要 JSONL,你手里只有一个 JSON 数组;或者拿到几万行 JSONL,导入报错却不知道坏在哪一行。为改个数据格式专门开 IDE、装 Python 环境,有点小题大做。
星点的 JSONL / NDJSON 转换工具 就是干这件事的:JSON 与 JSONL 互转、逐行校验、逐行格式化,打开网页即用,解析全程在浏览器本地完成,数据不上传。
它不是”又一个 JSON 格式化”,而是专门解决行式 JSON 数据的转换与排错——转换只是第一步,能告诉你”第 37 行坏了、坏在哪”才是关键。
🚀 怎么用:三种模式,一个主按钮
打开 https://www.xingdian.net/app/json/jsonl/,界面左输入右输出,顶部一排按钮。核心操作就四步。
- 选模式。顶部有
JSON → JSONL、JSONL → JSON、JSONL 校验/格式化三个选项,切换时输入框会自动填入对应示例,可先跑通再换自己的数据。 - 粘贴数据。把内容粘到左侧编辑区;“示例”恢复当前模式示例,“清空”一键清掉。JSON 转 JSONL 模式下左侧还有状态提示,先帮你判断输入是不是合法 JSON。
- 执行。点主按钮(文案随模式变),右侧出结果;出错则在编辑区上方出现红色错误条,写明第几行(JSON 转 JSONL 时还带列号)。
- 取走结果。点”复制”或”下载”,文件名按模式自动决定。
| 模式 | 主按钮 | 输出 | 下载文件名 |
|---|---|---|---|
| JSON → JSONL | 转换为 JSONL | 每行一条紧凑 JSON | output.jsonl |
| JSONL → JSON | 转换为 JSON | 2 空格缩进的 JSON 数组 | output.json |
| JSONL 校验/格式化 | 校验 / 格式化 | 规范化后的 JSONL | formatted.jsonl |
🔧 核心功能详解
1. JSON 数组 → JSONL
粘贴一个顶层为数组的 JSON,工具把每个元素紧凑序列化,一行一个:
[ { "id": 1, "name": "张三", "age": 28, "active": true }, { "id": 2, "name": "李四", "age": 34, "active": false }, { "id": 3, "name": "王五", "age": 22, "active": true }]{"id":1,"name":"张三","age":28,"active":true}{"id":2,"name":"李四","age":34,"active":false}{"id":3,"name":"王五","age":22,"active":true}几个真实的行为细节:
- 必须顶层是数组。给一个对象
{"id":1,...},工具会直接提示”JSONL 需要 JSON 数组”,不会替你拆。单条记录想转行式结构,先包一层[ ]。 - 空数组输出为空。
[]转出来是空字符串,因为没有记录可写。 - 标量元素也能转(
[1,2,3]得到三行1、2、3),语法合法,但多数数据管道期望每行是对象,转之前想清楚下游要什么。 - 输出是紧凑格式(无空格缩进),这是 JSONL 的常规写法。
2. JSONL → JSON 数组
反方向:逐行解析、跳过空行,把每行结果收进数组,用 2 空格缩进美化输出。成功时底部提示”已转换为 JSON 数组(N 条)“——核对条数是否对得上,这是检查”导入后少没少数据”最快的办法。
注意它的错误策略:遇到第一条非法行就停下并报行号,适合”数据基本没问题、快速转一下”;想一次看清所有坏行,用第三个模式。
3. 逐行校验与格式化
这才是排错主力。
- 全量校验:每行都检查,非法行集中列出——红色提示条写”共 N 行,其中 M 行非法”,下面逐条”第 X 行:错误信息”。不用反复转换、改一行跑一次。
- 全部合法才格式化:校验通过后输出规范化结果,底部显示”共 N 行,全部合法”。
- 空行自动跳过:不计数、不输出,顺手清掉多余空行。
- “每行美化”开关:默认关闭,输出是严格的一行一条;打开后每条按 2 空格展开成多行,只为阅读。工具自己也提示了:美化后不再是严格 JSONL,别再拿去导入。
📊 JSONL 和 JSON 数组到底差在哪
| 维度 | JSON 数组 | JSONL / NDJSON |
|---|---|---|
| 整体结构 | 一个完整文档,外层 [ ] | 每行一个独立 JSON 值,无外层符号 |
| 记录分隔 | 逗号 , | 换行符 |
| 读取方式 | 通常需整体读入再解析 | 可逐行读取、流式处理 |
| 追加记录 | 要在 ] 前补逗号和内容 | 文件末尾直接加一行 |
| 单条出错 | 整个文件解析失败 | 可定位到具体行 |
| 常见扩展名 | .json | .jsonl、.ndjson、.jsonlines |
| 适合场景 | 接口响应、配置、嵌套文档 | 日志、数据集、批量导入、训练数据 |
一句话取舍:JSON 适合”一个文档”,JSONL 适合”很多条记录”。后者牺牲整体包裹感,换来可追加、可流式、单行可定位。
这也是它在这些地方流行的原因:
- 日志:每条日志一行 JSON,
tail -f、grep直接可用,追加写不破坏已有内容。 - 大模型微调数据:常见做法是每行一个样本(如一行一个
{"messages":[...]}),导入前必须保证每行都是合法 JSON。 - 批量导入分析型数据库:BigQuery 的换行分隔 JSON、ClickHouse 的 JSONEachRow 都属此类。
- Elasticsearch bulk 接口:要求 NDJSON,但形态是”元数据行 + 文档行”成对出现,每行仍是独立 JSON——本工具能校验语法,但不懂这层业务规则。
另外,JSONL 与 NDJSON 语法上没有区别,只是两个社区叫法,扩展名和 MIME(常见 application/x-ndjson、application/jsonl)各有习惯,看到 .ndjson 直接按 JSONL 处理即可。
⚠️ 常见错误与排查
| 现象 | 原因 | 解决 |
|---|---|---|
| 提示”JSONL 需要 JSON 数组” | 顶层是对象或单个值 | 用 [ ] 包成数组;单条记录无需转换 |
| 报”第 N 行第 M 列”语法错误 | JSON 不合法:单引号、尾随逗号、键名缺引号 | 按行列定位修改,或先过一遍 JSON 校验 |
| JSONL 转 JSON 只报一处错 | 逐行解析,遇首个非法行即停 | 改用校验/格式化模式,一次拿全坏行 |
| 多行非法且都是 “Unexpected token” | 行间加了逗号,或整段还是数组写法 | 记录之间不能有逗号,也不能有 [ ] |
| 一条记录被拆成多行 | 把美化后的 JSON 直接拼一起 | 先用 JSON 压缩 压成单行 |
| 第一行就报错,其余看着正常 | 文件带 UTF-8 BOM(记事本/Excel 另存常见) | 另存为”无 BOM 的 UTF-8” |
| 美化后导入下游失败 | 美化输出是多行缩进,不是严格 JSONL | 关掉开关,用紧凑模式重新导出 |
排查顺序:先校验拿全量错误 → 逐行修 → 再转换 → 核对条数,比”转换失败—猜—再转换”高效得多。
❓ 常见问题
JSONL 和 NDJSON 是同一个东西吗?
语法层面是同一个格式:每行一个独立 JSON 值、以换行分隔。区别只在叫法和文件习惯(.jsonl / .ndjson),用本工具时不需要区分。为什么 JSON 转 JSONL 一定要顶层是数组?
JSONL 是"多条记录、一行一条",单个对象只是一条记录,工具无法替你决定拆成几行。把多条数据组织成数组再转,语义才明确。空数组得到空结果,符合预期。互转会丢数据吗?
记录内容不丢:元素与行一一对应,字段、类型、嵌套结构都保留。变的是排版——JSON 转 JSONL 输出紧凑行,JSONL 转 JSON 输出 2 空格缩进,原始空白不保留。业务字段是否完整,需要你自己确认。校验通过就能直接拿来训练模型吗?
不等同。工具只做 **JSON 语法校验**(每行能否解析);字段名对不对、`messages` 结构符不符合平台要求,属于 Schema 层,要另行确认,可配合 [JSON Schema 工具](https://www.xingdian.net/app/json/schema/)。文件特别大,浏览器会不会卡?
解析在浏览器本地同步进行,能处理多大取决于设备内存,工具没有承诺固定上限。几 MB 到几十 MB 通常没问题;几百 MB 的日志建议先切分,或用命令行(如 jq)做流式转换。空行和末尾换行怎么算?
空行会被跳过,不计入行数也不产生空记录;末尾多一个换行不影响结果。需要"严格无空行"的文件,用校验/格式化模式跑一遍即可。下载下来的是什么文件?
JSON 转 JSONL 得到 output.jsonl(application/x-ndjson),JSONL 转 JSON 得到 output.json(application/json),校验/格式化得到 formatted.jsonl。若开了"每行美化",结果仅建议阅读。数据会上传到服务器吗?
不会。解析、转换、校验全部在浏览器本地执行,不产生网络请求,界面底部有"本地处理 · 数据不上传"标识。处理含用户信息的 JSONL 时,这点比功能多寡更重要。🧭 相关工具
- 星点 JSON 工具总览:11 个 JSON 工具的用途与选型,先看这篇能少走弯路。
- JSON 格式化:单条 JSON 或小数组美化阅读,支持大文件与错误定位。
- JSON 校验:整体语法校验,转换前先确认原文件是否合法。
- JSON 压缩:把美化过的 JSON 压回单行,“修复跨行记录”的常用前置步骤。
文章分享
如果这篇文章对你有帮助,欢迎分享给更多人!