DevTool 团队

JSON 格式化工具怎么挑:错误定位、修复与隐私

粘一段 JSON,哪个工具值得用?这篇给判断标准而不是工具清单:先按场景选路(临时看一眼用在线工具、天天改用编辑器、批量与 CI 用 jq、团队规范用 schema 校验),再讲评价一个 JSON 工具的三件套——报错定位到行列还是一句 invalid、修复是预览确认还是静默改写、大文件是分级降级还是卡死;最后给隐私核实方法:断网测试与分享链接的 URL fragment 机制,以及什么时候在线工具不如编辑器和命令行。

先选路:你要对 JSON 做什么

「JSON 格式化工具」搜索框里敲下这串词的人,要的其实不是同一个东西。按你手头的事选路:

你要做的事 顺手的选择 为什么
看一眼接口响应、检查一段配置、排查一个报错 在线工具(如本站 JSON 在线解析) 零安装、贴进来即用,树形视图顺带解决「浏览结构」
天天要改 JSON 配置文件 代码编辑器(VS Code / JetBrains) 语法高亮、保存即校验、与 git 工作流一体
批量转换、CI 里校验 命令行(jq、spectral) 可复现、可脚本化,进 pipeline
团队接口契约检查 Schema 校验(在线或 CI 内) 语法对≠结构对,契约要 Schema 管

本文重点讲第一条路——因为在线工具质量差距最大,也是最容易被「功能同质化」话术糊弄的一类。判断标准有三件套。

三件套之一:报错定位,不是「invalid」

粘贴一段坏 JSON,工具给你的第一句话暴露了它的实现质量:

  • 差的实现:一句 Invalid JSON 或 Unexpected token,你自己找哪行错了;
  • 好的实现:行列号 + 具体原因——「第 12 行第 8 列:字符串缺少右引号」「第 30 行:对象有多余的逗号」。

这个差距在日常场景里就是几分钟和几秒的区别:接口返回了 2MB 的响应,报错只有一句 invalid 时,你要在压缩成一行的文本里肉眼找问题。本站的报错直接给行列与原因——解析器的错误码被映射成可读的说明,而不是把 JSON.parse 的原始异常甩给你。

顺带一个高频案例:Unexpected token 报在 JSON 第一个 { 上,九成不是 JSON 的问题——是你拿到的是「包了一层引号的 JSON 字符串」(二次序列化)或响应根本是 HTML 错误页。前者可以直接用一键修复解开(被转义的 JSON 字符串在修复覆盖清单里),后者的正确动作是去查接口为什么返回了错误页。

三件套之二:修复要预览确认,不要静默改写

「一键修复」现在是标配,但实现姿态分两档:

  • 静默改写:点一下,输入直接被替换。快,但你不知道它改了什么——尾逗号删了 3 处?还是把你的字符串引号全换了?对配置文件来说,「改了什么」和「改对了」同样重要。
  • 预览确认:先给改动摘要(修了几处、每处什么变化),确认后写回。本站走这条路线,覆盖十几类常见非法写法:缺引号、单引号、尾随逗号、注释、缺逗号缺括号、被截断的 JSON、Python 风格的 True/False/None、被转义的 JSON 字符串、NDJSON 多行——这些多是从别的语言、别的工具、日志里复制出来的真实伤情。

还有一个更隐蔽的坑:有些修复实现对「完全不是 JSON 的输入」不报错,而是把整段文本包成一个字符串字面量——输入 @@@ junk @@@ 输出 "@@@ junk @@@"。那不是修复,是把你的数据降级成无意义标量。好的实现会显式拦截这种情况并判失败。

三件套之三:大文件的表现

大文件区分的不是功能而是工程:10MB 的 JSON 粘进来,差工具直接卡死标签页,好工具有分级降级——超过阈值时从重型编辑器降级到纯文本模式,牺牲高亮换取可用,格式化、校验、搜索照常。判断方法很土但有效:拿你们线上最大的一个接口响应试一次。

配套能力还有两个值得点名:大文件搜索(按路径或按值找字段,而不是浏览器 Ctrl+F 在压缩文本里抓瞎)和键排序(对接前后比对、生成 canonical 形态时省事)。

隐私口径:怎么核实「不上传」

工具页都会写「数据不上传」,核实办法有两个,都是自助可做的:

  1. 断网测试:切断网络再粘贴内容。本地处理的工具一切照常(格式化、树形、报错都在),要上传的工具立刻罢工。
  2. Network 面板:打开开发者工具的 Network 面板,粘贴内容、触发操作,看有没有新请求发出。

本站的口径可以这么验证,但有一个例外要说清楚:分享链接。生成分享链接时,内容被 base64 编码放进 URL 的 #fragment 部分——浏览器按规范不会把 fragment 发给服务器,所以生成链接这个动作本身不上传数据;但链接本身就携带全部内容,把它贴进聊天工具,等于把内容发给了聊天服务商,而且超长的内容(链接总长 16,000 字符封顶)会拒绝生成并引导你下载文件。这是「处理不上传」和「分享即携带」的边界,用的时候分清楚。

真话:什么时候别用在线工具

  • 文件超过浏览器顺手处理的量级(几十 MB 的导出、全量转储):老实上 jq——jq . big.json > pretty.json,命令行不吃内存亏;
  • 校验要进 CI、要可复现:在线工具的「我验证过了」不构成证据,jq + spectral 的退出码才是;
  • 你就是天天住在 VS Code 里的人:编辑器已经给了高亮、保存校验、折叠,切到浏览器的唯一理由是树形浏览和给别人看——那就把这个理由用足(树视图里点字段复制 JSONPath,贴给同事比自己描述路径快得多)。

在线工具的真正领地:低频、临时、要看结构的场景——它把这个场景做到几秒内完成,就是合格的工具。

常见问题

在线 JSON 工具和编辑器插件比,各自适合谁?

临时任务(看一眼接口响应、检查一段配置、排查一个报错)适合在线工具:零安装、贴进来即用、树形视图顺带给了浏览结构的能力。天天要改 JSON 配置的人适合编辑器(VS Code 等):语法高亮、保存即校验、和 git 工作流无缝。批量处理与 CI 适合命令行(jq):可复现、可脚本化。三者不是竞争关系,是同一份 JSON 的三种工作节奏。

怎么验证一个在线工具真的不上传数据?

两个自助办法:断网测试——切断网络后粘贴内容,本地处理的工具功能照常(格式化、树形展开、报错都在),要上传的工具立刻罢工;或者打开浏览器开发者工具的 Network 面板粘贴内容,观察有没有发出请求。另外注意分享功能的机制:内容编码在 URL 的 #fragment 里时不会发给服务器(浏览器按规范不上传 fragment),但链接本身就携带内容,贴进聊天工具等于把内容发出去——和「不上传」是两回事。

JSON 修复功能会不会悄悄改坏数据?

取决于工具有没有「预览确认」环节。负责任的修复流程是:先展示改动摘要(改了几处、改成什么),用户确认后才写回;并且要拦截「伪修复」——有些库对完全不是 JSON 的输入不报错,而是把整段文本包成一个字符串字面量,那不是修复,是把数据变成了无意义的标量。用修复前先看一眼 diff,是对自己数据负责的最低成本。

JSON Schema 校验和语法校验有什么区别?

语法校验回答「这是不是合法 JSON」——括号引号逗号对不对;Schema 校验回答「这是不是我要的 JSON」——字段齐不齐、类型对不对、枚举值在不在范围内。比如语法合法但把 age 写成了字符串、少了必填的 email,只有 Schema 校验能抓住。报错质量也要看定位:好的实现把每条 Schema 违规定位到具体行列,而不是甩一段校验器输出。