JSONL 转 JSON 数组的完整指南:日志、导出与训练集合并

有一类很常见的别扭:你手里的文件是一行一个 JSON 对象,中间没有逗号,外面也不套方括号。它叫 JSONL,也叫 NDJSON。可下游那个工具偏偏只认一个标准的 JSON 数组。两种形态装的是同一份数据,排布却不一样,直接喂过去就报错。这篇把这件事讲透:JSONL 到底是什么,逐行解析怎么把它收成数组,日志和训练集这类场景怎么合并,以及什么时候要反着来。

JSONL 和 JSON 数组,差在哪一层

JSONL 把每一条记录单独放一行,行与行之间没有逗号,文件外层不套 []。一行 {"id":1} 接一行 {"id":2},就是两条独立记录。好处是流式:读取方一行一行往下读,永远不必把整份文件加载进内存,所以它适合无上限增长的数据。

JSON 数组是另一套规矩。整份内容是一个值,通常长这样 [{"id":1},{"id":2}],元素之间用逗号连,外面有方括号包住。它适合一次性解析,适合 array.map、filter 这种把全部数据当成一个整体来操作的代码。

两者谁也不比谁高级,只是面向的读取方式不同。问题出在工具链的两端讲不同方言,这时候才需要转换。

逐行解析:把每行的结果放进数组

JSONL 转 JSON 数组,核心动作就一句话:逐行解析,每行解析出的值按顺序放进同一个数组。具体走这么几步:

• 按换行把输入切成若干行;
• 空行直接跳过,不计入结果;
• 对每个非空行单独跑一次 JSON 解析;
• 把解析出的值按原顺序推入一个数组;
• 全部解析完,把这个数组按你选的缩进(紧凑 / 2 空格 / 4 空格)打印出来。

关键在「单独解析每行」。如果第 7 行少了逗号或者多了个右括号,工具会停在那里,直接告诉你「第 7 行」加上解析器的原始报错,而不是让你在一大片文本里大海捞针。我自己处理过一份两万行的导出,加载器只甩一句没有位置的 invalid JSON,靠肉眼根本找不到。换成按行号定位,几秒就跳到了那条尾逗号没删干净的记录上。这正是 JSONL 转 JSON 转换器 比手动拼数组省心的地方。

一个真实的输入输出例子

假设你有这么三行 JSONL:

{"user":"li","action":"login"}
{"user":"han","action":"upload"}
{"user":"mei","action":"logout"}

选「JSONL 转 JSON 数组」,2 空格缩进,输出就是一个标准数组:

[
  {"user":"li","action":"login"},
  {"user":"han","action":"upload"},
  {"user":"mei","action":"logout"}
]

三行变成一个值。现在它能被 JSON.parse 一次吃下,能 array.map 遍历,能丢进任何只接受数组的图表组件或笔记本。

把日志、导出、训练集合并成数组

合并这个动作,在三类场景里几乎天天发生:

第一类是应用日志。服务把每条事件按行写进 .jsonl,你想把当天的事件拉进控制台随手分析。控制台要的是数组,不是流,转一下就齐了。

第二类是大数据导出。Spark、BigQuery 这些工具吐出来的常是 NDJSON,而你后续要做的统计逻辑写在一段只认数组的脚本里。转成数组,所有记录排好序,后面的处理逻辑一行不用改。

第三类是机器学习数据集。原型阶段你常把样本攒成数组,可不同环节对格式的要求并不统一,有时要数组,有时要 JSONL。两种形态来回切的需求,远比想象中频繁。

反过来:JSON 数组转 JSONL

方向是双向的。把方向切到「JSON 数组转 JSONL」,粘进一个数组,工具会把每个元素写成紧凑的一行,没有缩进,也没有尾逗号:{"a":1} 一行,{"a":2} 一行。这正是流式读取方、BigQuery 或 Snowflake 的导入任务、以及 OpenAI 式微调文件想要的排布,每行一条训练样本。

要提醒一点:这不是 JSONL 美化工具。美化工具是就地给每行重新缩进,文件还是 JSONL。本转换器改变的是结构形态,JSONL 变成一个数组,数组变成每行一个对象。如果你只是想要更整齐的 JSONL,不改变形态,那该用 JSON Lines 格式化工具,而不是转换器。

几个容易踩的坑

方向选错是头号问题。方向停在「JSONL 转 JSON 数组」却粘进了一个真数组,数组外层的方括号和元素间逗号在单行里不合法,第一行就解析失败。另一个常见错是手搓 JSONL 时把数组元素复制过来、尾逗号忘了删。一行以逗号结尾,单独看就不是合法 JSON。记住一条:JSONL 的每一行都要能独立成一个完整的值,后面不带任何东西。

整个过程全在浏览器标签页里跑,日志、数据集、训练样本都不上传,也不写进分享链接。要分享结果,用复制或下载按钮把文件直接发出去就好。

---

Made by Toolora · Updated 2026-06-13