博客

在 Mac 上格式化和检查 JSON:从接口响应到可读数据

将紧凑的接口响应整理成可读 JSON,排查语法错误,无需把内容提交给在线格式化网站。

在 Mac 上检查一段紧凑的 JSON 响应,可以将 JSON 本身粘贴到 Frset 的 JSON 工具中,选择格式化;需要紧凑版本时,再使用压缩。两种操作都会检查 JSON 语法,但不会确认字段和值是否符合你的接口要求。

复制响应正文,不要带入外围日志

接口工具可能同时显示状态、响应头和正文。格式化需要的是 JSON 部分。对象前多出一句“响应已接收”,或复制消息时带入代码围栏,都可能让原本有效的 JSON 无法解析。

修改前保留原始响应。例如,{"project":"demo","enabled":true,"items":[1,2]} 是一个可用于检查操作流程的小型有效对象。格式化让结构更容易阅读,不需要改变其中的数据含义。

使用 Frset 格式化或压缩

  1. 打开 Frset 搜索,选择 JSON;未修改关键词时,可以使用默认的 /json。
  2. 将 JSON 正文粘贴到工具输入区域。
  3. 选择格式化添加便于阅读的缩进,或选择压缩去掉不必要的空白。
  4. 运行工具,检查结果。
  5. 将已复制的结果粘贴到编辑器、接口工具或工作笔记中。

成功结果会加入 Frset 历史记录,并复制到系统剪贴板。之后可以通过剪贴板管理器找回,可访问范围和保留期限取决于方案与设置。工具使用额度也受方案影响。

JSON 格式化在本地执行,不需要 AI 服务商或在线格式化网站。工具改变的是排版,同时保留键顺序、数字字面量和字符串内容。压缩移除的是格式空白,不会删除字符串值内部的空格,也不等于文件压缩或加密。

解析失败时检查哪些地方

解析失败时,先核对复制进来的内容,不要默认工具会替你修复。常见问题包括:

  • 缺少逗号,或花括号、方括号没有配对。
  • 键名或字符串使用了单引号,而 JSON 要求双引号。
  • 最后一个成员或数组元素后多了逗号。
  • 输入中混入注释、日志前缀或 HTML 错误页面。
  • 字符串里的引号或换行没有正确转义。

JSON 规范 RFC 8259 定义了格式要求。JavaScript 对象字面量,以及允许注释的配置格式,不一定是有效 JSON。明确修正源内容后再试;格式化器不会判断一个缺失的值本来应该是什么。

区分数据可读与数据正确

格式化成功,说明输入可以被解析,不代表其中的标识符存在、时间戳单位正确,或字段符合接收方接口约定。应用的数据结构和业务规则,仍应在相应开发工具中校验。

也要区分字符串和数字。把 "0012" 改成 12,即使仍然能解析,数据也已经变化。日期字段里出现不熟悉的整数时,可以通过时间戳转换指南单独检查单位和时区。

经常处理的内容,可以为重要副本设置别名,或把需要维护的示例保存为笔记,详见代码与配置片段复用。可读的响应有助于排错,但仍需结合原始请求和接口行为判断。