JSONL / NDJSON 完全指南:JSON 互转、逐行校验与格式化(免费在线)

2469 字
12 分钟
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/,界面左输入右输出,顶部一排按钮。核心操作就四步。

  1. 选模式。顶部有 JSON → JSONL、JSONL → JSON、JSONL 校验/格式化 三个选项,切换时输入框会自动填入对应示例,可先跑通再换自己的数据。
  2. 粘贴数据。把内容粘到左侧编辑区;“示例”恢复当前模式示例,“清空”一键清掉。JSON 转 JSONL 模式下左侧还有状态提示,先帮你判断输入是不是合法 JSON。
  3. 执行。点主按钮(文案随模式变),右侧出结果;出错则在编辑区上方出现红色错误条,写明第几行(JSON 转 JSONL 时还带列号)。
  4. 取走结果。点”复制”或”下载”,文件名按模式自动决定。
模式主按钮输出下载文件名
JSON → JSONL转换为 JSONL每行一条紧凑 JSONoutput.jsonl
JSONL → JSON转换为 JSON2 空格缩进的 JSON 数组output.json
JSONL 校验/格式化校验 / 格式化规范化后的 JSONLformatted.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 压回单行,“修复跨行记录”的常用前置步骤。

文章分享

如果这篇文章对你有帮助,欢迎分享给更多人!

相关文章 智能推荐
1
星点JSON工具完整指南 - 11个免费在线JSON工具导航
JSON工具 星点 JSON 工具系列完整指南:JSON 格式化、压缩、校验、转换、Schema、对比、过滤、扁平化、排序、JSONPath、JSONL 等 11 个在线工具一站式导航,按场景帮你选对工具,浏览器本地处理不上传。
2
星点二维码工具完整指南 - 7 个免费在线二维码与条码工具导航
二维码工具 星点二维码工具系列完整指南:二维码生成与美化、解码识别、样式/标签模板、批量生成与 A4 打印、场景码(电话/短信/邮件/Wi-Fi/地图)、条形码生成与识别 7 个工具一站式导航,含按场景选工具、对照表与 FAQ,全部浏览器本地处理不上传。
3
正则搜索工具 - 在线查找全部匹配、逐个跳转与上下文定位(免费)
正则工具 在线正则搜索工具:在长文本中查找全部匹配并逐个跳转,显示第 N/总数、所在行列与前后文,支持 g/i/m/s/u 等 Flags、结果复制。讲清它与正则测试器的区别,附日志排查示例、常见错误与 FAQ;浏览器本地执行,文本不上传。
4
在线二维码生成器怎么用 - 自定义颜色、Logo 与 SVG 下载(免费)
二维码工具 星点在线二维码生成器,输入文字或网址即可生成二维码:支持前景/背景色、渐变、四种码点、三种定位角、中心 Logo、尺寸与边距调整,内置 8 套样式预设、可扫性检测和扫码诊断,一键下载 PNG/SVG 或复制图片。纯浏览器本地生成,内容不上传服务器,免费、免注册、无水印。
5
星点短链接 - 在线短网址生成工具,把长链接变短(免费)
URL工具 星点短链接是一款免费的在线短网址生成工具:一键把冗长的长链接压缩成简短、清爽、便于分享的短链,支持自定义有效期、访问统计、启用禁用与安全风控。登录即可创建和管理,短链复用主站已备案域名的路径前缀 www.xingdian.net/s,本文含完整使用步骤、短码原理、跳转机制、安全机制与常见问题。
随机文章 随机推荐
公告
🎉 已升级 2.0 版本,欢迎使用。
分类
标签
站点统计
文章
247
分类
31
标签
973
总字数
633,901
运行时长
0 天
最后活动
0 天前

目录