← 所有文章
2 分钟阅读

发给同事或 AI 前,先把 JSON 清理一下

一个很短的清单:格式化、裁剪、脱敏,让排查更快,也更安全。

JSON 很容易复制,也很容易把不该发的内容一起发出去。

在把 API 响应贴到聊天、工单或 AI 提示词之前,花一分钟清理一下。你通常会得到更好的答案,也能降低泄露隐私的风险。

第一步:格式化

压缩后的 JSON 很难读:

{"status":"failed","error":{"code":"INVALID_URL","message":"Campaign URL is missing a host"}}

格式化后,结构就清楚了:

{
  "status": "failed",
  "error": {
    "code": "INVALID_URL",
    "message": "Campaign URL is missing a host"
  }
}

同事真正需要的通常是结构:哪个字段存在,哪个字段缺失,错误在什么位置。

第二步:删掉无关字段

只保留能说明问题的最小例子。删掉巨大的数组、重复对象,以及和问题无关的 tracking 字段。

好的排查 JSON 不一定完整,但一定聚焦。

第三步:替换值,不破坏结构

用清楚的占位符替换隐私值:

  • user@example.com -> user@example.test
  • sk_live_... -> secret_placeholder
  • 真实姓名 -> Example User
  • 地址、电话、支付信息 -> 整段删除或完全替换

尽量保留字段名和数据类型。同一个字段里放一个假的字符串,比直接删掉字段更有用。

第四步:改完后再校验

脱敏时很容易把 JSON 改坏。少一个引号或多一个尾随逗号,大家就会开始排查你的例子,而不是排查真正的问题。

分享前,用 JSON 格式化工具 在本地格式化并校验最后的片段。

最好的共享 JSON 是小、有效、无聊的。正因为无聊,它才有用。

相关阅读