MV Tools

实用 JSON 调试演示

如何使用格式化、验证和 JSONPath 调试 JSON

面向 API 响应、配置文件和测试数据的可重复调试流程:不要把格式化误当成数据正确。

MV Tools 编辑团队更新于 约 7 分钟阅读

打开工具

区分语法、结构和业务含义

JSON 的问题并不相同。语法错误会让它无法解析,例如漏逗号、括号不配对、键未加引号、非法转义或尾随逗号。结构问题则是 JSON 有效但形状不对,例如期望对象却得到数组、缺字段,或数字被存成字符串。业务含义问题需要结合场景判断,例如日期可解析但不合理、ID 对应错误记录或值已过期。

格式化会让结构更容易看清,但不能证明数据符合应用要求。

有效 JSON 只确认语法与顶层类型,不代表应用 Schema 正确。
有效 JSON 只确认语法与顶层类型,不代表应用 Schema 正确。

使用范围逐步缩小的流程

先取能复现问题的最小真实样本。格式化后确认能解析,再只查看相关分支。

  1. 编辑前先格式化。

    统一缩进,方便检查括号、数组和同级字段。

  2. 每次重要编辑后验证。

    验证只确认 JSON 语法和顶层类型,并不校验自定义 Schema。

  3. 查询相关分支。

    用 $.items[0].id 这样的简单路径定位对象字段或指定数组元素。

  4. 复制最小测试样本。

    只保留复现 API 或配置问题所需的安全数据。

先让嵌套和同级字段清晰可读。
先让嵌套和同级字段清晰可读。

了解当前支持的路径语法

MV Tools 支持以 $ 开头的简单路径:对象字段用 .field,数字数组索引用 [0],例如 $.user.email、$.items[0].id、$.config.features[2].name。这不是完整 JSONPath:不支持筛选、通配符、递归下降、带引号的键或非数字数组选择器。

键名包含标点或空格时,请检查或简化源数据,不要期待这里支持方括号带引号写法。

使用点属性和数字索引的窄路径检查一个分支。
使用点属性和数字索引的窄路径检查一个分支。

正则用于文本检查,不用于解析 JSON

JSON 已解析或格式化后,Regex Tester 适合查找 ID 模式、预览替换、检查捕获分组,或检查字段中的文本。不要把正则当作通用 JSON 解析器:转义引号、嵌套对象、数组和空白会让这种方式很脆弱。

测试器遵循 JavaScript 正则和 flags,显示高亮匹配、编号与命名捕获组及替换预览。其他语言或引擎中有效的正则,在 JavaScript 中可能表现不同。

先解析 JSON,再用正则检查文本值或替换。
先解析 JSON,再用正则检查文本值或替换。

工具限制与安全处理

JSON Toolkit 在浏览器本地运行,输入上限为 2 MB;格式化、压缩、验证、键排序、转义、反转义和简单路径查询不会把文本上传到 MV Tools。Regex Tester 也在本地运行,测试文本上限为 500 KB,最多显示 1000 个匹配。

即使在本地处理,也不要在没有授权时粘贴生产密钥、访问令牌、个人信息或完整客户数据。优先使用已脱敏的最小复现样本。

有效 JSON 只确认语法与顶层类型,不代表应用 Schema 正确。
有效 JSON 只确认语法与顶层类型,不代表应用 Schema 正确。

常见问题

“JSON 有效”是否代表 API 响应正确?

不代表。它只确认 JSON 可解析并显示顶层类型,仍需由应用校验 Schema 和业务规则。

能使用 $.items[?(@.id==1)] 这样的筛选吗?

不能。当前只支持简单的点属性和数字数组索引路径。

正则能可靠解析任意 JSON 吗?

不能。应先解析 JSON,正则只用于检查或转换文本值。