区分语法、结构和业务含义
JSON 的问题并不相同。语法错误会让它无法解析,例如漏逗号、括号不配对、键未加引号、非法转义或尾随逗号。结构问题则是 JSON 有效但形状不对,例如期望对象却得到数组、缺字段,或数字被存成字符串。业务含义问题需要结合场景判断,例如日期可解析但不合理、ID 对应错误记录或值已过期。
格式化会让结构更容易看清,但不能证明数据符合应用要求。
使用范围逐步缩小的流程
先取能复现问题的最小真实样本。格式化后确认能解析,再只查看相关分支。
编辑前先格式化。
统一缩进,方便检查括号、数组和同级字段。
每次重要编辑后验证。
验证只确认 JSON 语法和顶层类型,并不校验自定义 Schema。
查询相关分支。
用 $.items[0].id 这样的简单路径定位对象字段或指定数组元素。
复制最小测试样本。
只保留复现 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 Toolkit 在浏览器本地运行,输入上限为 2 MB;格式化、压缩、验证、键排序、转义、反转义和简单路径查询不会把文本上传到 MV Tools。Regex Tester 也在本地运行,测试文本上限为 500 KB,最多显示 1000 个匹配。
即使在本地处理,也不要在没有授权时粘贴生产密钥、访问令牌、个人信息或完整客户数据。优先使用已脱敏的最小复现样本。
常见问题
“JSON 有效”是否代表 API 响应正确?
不代表。它只确认 JSON 可解析并显示顶层类型,仍需由应用校验 Schema 和业务规则。
能使用 $.items[?(@.id==1)] 这样的筛选吗?
不能。当前只支持简单的点属性和数字数组索引路径。
正则能可靠解析任意 JSON 吗?
不能。应先解析 JSON,正则只用于检查或转换文本值。