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.testsk_live_...->secret_placeholder- 真实姓名 ->
Example User - 地址、电话、支付信息 -> 整段删除或完全替换
尽量保留字段名和数据类型。同一个字段里放一个假的字符串,比直接删掉字段更有用。
第四步:改完后再校验
脱敏时很容易把 JSON 改坏。少一个引号或多一个尾随逗号,大家就会开始排查你的例子,而不是排查真正的问题。
分享前,用 JSON 格式化工具 在本地格式化并校验最后的片段。
最好的共享 JSON 是小、有效、无聊的。正因为无聊,它才有用。