{} HiJSON

使用教程

API 调试中的 JSON 实践

REST API 开发中,JSON 是最常见的请求与响应格式。无论是前端联调、后端自测还是 QA 验证,高效处理 JSON 响应能显著缩短调试周期。本文介绍一套基于 HiJSON 的实战工作流。

典型调试场景

  • 接口返回异常 — 响应体结构不符合预期,需要快速定位缺失或错误的字段
  • 分页数据核对 — 列表接口返回大量对象,需对比多个字段是否一致
  • 日志分析 — 从 ELK / CloudWatch 复制 JSON 日志,查找特定事件
  • Mock 数据编辑 — 修改测试 JSON 后重新提交或分享给同事
  • Webhook 排查 — 检查第三方回调 payload 的完整结构

工作流 1:快速分析 API 响应

  1. 在 Postman、curl 或浏览器 DevTools 中复制 API 响应 JSON。
  2. 打开 HiJSON,粘贴到左侧输入框,按 Ctrl+Enter 解析。
  3. 使用树形视图展开关键路径,检查字段类型和值是否正确。
  4. 若结构过深,在大纲导航面板中快速跳转。
  5. 点击可疑节点,在详情面板中查看格式化后的完整值并复制。

HiJSON 所有操作在浏览器本地完成,适合处理含 token、用户信息等敏感数据的响应,无需担心上传到第三方。

工作流 2:JSONPath 精准定位

当响应体很大时,手动展开树形结构效率低。使用 JSONPath 直接查询目标字段:

$.data.items[*].order_id          → 所有订单 ID
$.errors[?(@.code==400)]           → 400 错误详情
$.meta.pagination.total             → 分页总数

在 HiJSON 搜索框输入表达式后,匹配结果高亮显示。开启「记忆模式」可保存常用路径,下次调试同类接口时一键复用。详见 JSONPath 入门教程

工作流 3:多字段对比表格

列表接口返回数组时,经常需要核对多个字段。HiJSON 的多字段对比功能可将数组转为表格:

$.data.orders[*].{id, status, amount, created_at}

这将生成一个四列对比表,每行对应一条订单记录。适用于:

  • 检查所有订单状态是否合法
  • 对比不同请求返回的同一字段
  • QA 验证批量数据的字段完整性

工作流 4:团队协作分享

调试中发现问题需要同事协助?HiJSON 支持通过 JSONBin.io 生成分享链接:

  1. 在 HiJSON 设置中配置 JSONBin.io API Key(Key 仅存储在本地浏览器)。
  2. 解析 JSON 后,在详情面板点击分享按钮。
  3. 复制生成的链接发送给同事,对方打开后自动加载并解析该 JSON。

注意:分享功能会将数据上传至 JSONBin.io,请勿分享含生产密钥或用户隐私的数据。

工作流 5:AI 辅助修改 Mock 数据

需要快速构造或修改测试数据?HiJSON 的 AI 功能支持自然语言编辑 JSON:

  • 「把所有 price 字段增加 10%」
  • 「给每个 user 对象添加 created_at 字段,值为当前时间戳」
  • 「将 status 为 pending 的订单改为 cancelled」

AI 返回修改后的 JSON 可一键应用到编辑器,再配合格式化功能生成干净的 Mock 数据文件。

调试技巧与注意事项

  • 区分 JSON 与 JSON Lines:.jsonl 文件每行一个 JSON 对象,HiJSON 支持拖拽导入。
  • 注意字符编码:API 响应中的中文或 emoji 需确保 UTF-8 编码,HiJSON 正确处理 Unicode。
  • 大文件性能:超过 5MB 的 JSON 解析可能较慢,建议先用 JSONPath 过滤关注部分。
  • 对比两次响应:分别解析两次响应,用路径记忆功能对比同一 JSONPath 的值变化。
  • 快捷键:Ctrl+Enter 解析、Ctrl+B 折叠面板、Ctrl+F 聚焦搜索,提升操作效率。

相关教程

开始调试 API 响应

粘贴 JSON 响应到 HiJSON,立即开始分析。

打开 HiJSON 工具 →