典型调试场景
- 接口返回异常 — 响应体结构不符合预期,需要快速定位缺失或错误的字段
- 分页数据核对 — 列表接口返回大量对象,需对比多个字段是否一致
- 日志分析 — 从 ELK / CloudWatch 复制 JSON 日志,查找特定事件
- Mock 数据编辑 — 修改测试 JSON 后重新提交或分享给同事
- Webhook 排查 — 检查第三方回调 payload 的完整结构
工作流 1:快速分析 API 响应
- 在 Postman、curl 或浏览器 DevTools 中复制 API 响应 JSON。
- 打开 HiJSON,粘贴到左侧输入框,按 Ctrl+Enter 解析。
- 使用树形视图展开关键路径,检查字段类型和值是否正确。
- 若结构过深,在大纲导航面板中快速跳转。
- 点击可疑节点,在详情面板中查看格式化后的完整值并复制。
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 生成分享链接:
- 在 HiJSON 设置中配置 JSONBin.io API Key(Key 仅存储在本地浏览器)。
- 解析 JSON 后,在详情面板点击分享按钮。
- 复制生成的链接发送给同事,对方打开后自动加载并解析该 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 聚焦搜索,提升操作效率。