本文介绍使用 javascript 的 `json.stringify` 配合自定义 replacer 函数，递归移除 json 中值为 `null` 或空字符串 `''` 的键，并自动剔除因此变为空的对象（如 `{}`），实现深度精简 json 结构。
在处理嵌套 JSON 数据时，常需清理“脏数据”——例如后端返回的字段含大量 null、空字符串 ""，甚至由此导致的冗余空对象（如 "image": {"src": null, "name": null}）。手动遍历不仅繁琐，还易遗漏深层嵌套。最佳实践是利用 JSON.stringify 的 replacer 函数机制：它会在序列化过程中对每个键值对进行过滤，返回 undefined 即跳过该属性；而当某对象所有子属性均被跳过时，该对象自然被省略（JSON 规范中不序列化 undefined 值，且空对象不会被保留）。
以下是核心解决方案：
function cleanJson(obj) {
return JSON.parse(
JSON.stringify(obj, (key, value) => {
// 过滤 null 和空字符串（注意：不过滤 0、false、[]、{} 等 falsy 但有意义的值）
if (value === null || value === '') {
return undefined;
}
return value;
})
);
}
// 使用示例
const original = {
"glossary": {
"title": "example glossary",
"GlossDiv": {
"title": "S",
"text": null,
"GlossList": {
"GlossEntry": {
"ID": "SGML",
"SortAs": "SGML",
"GlossTerm": "Standard Generalized Markup Language",
"Acronym": "SGML",
"Abbrev": "ISO 8879:1986",
"GlossDef": {
"para": "A meta-markup language, used to create markup languages such as DocBook.",
"definition": null
},
"GlossSee": "markup",
"window": {
"title": "Sample Konfabulator Widget",
"description": ""
}
}
}
},
"image": { "src": null, "name": null, "alignment": null },
"text": {
"data": "Click Here",
"size": null,
"style": "bold",
"name": "text1",
"hOffset": "",
"vOffset": "",
"alignment": "center",
"onMouseUp": null
}
}
};
console.log(cleanJson(original));
// 输出即为目标结构：无 null/'' 键，空对象（如 image）被完全移除，非空对象内仅保留有效字段✅ 关键特性说明：
- ✅ 递归生效：replacer 自动应用于所有层级，无需手动遍历；
- ✅ 空对象自动消失：若对象内所有属性均被 undefined 过滤，则该对象在序列化后不出现（如 "image": {} 不会生成）；
- ✅ 安全保留有效 falsy 值：0、false、[]、{} 等不会被误删（因仅判断 === null 或 === ''）；
- ✅ 零依赖、原生高效：纯 JS 实现，兼容所有现代浏览器及 Node.js。
⚠️ 注意事项：
- 此方法会丢失原始数据类型信息（如 Date、RegExp、undefined、函数等无法被 JSON 序列化的值会被忽略或报错，需确保输入为纯 JSON 兼容对象）；
- 若需保留 0、false 以外的其他“空值语义”（如 NaN、undefined 字段），可扩展判断逻辑；
- 如需同时删除仅含空格的字符串（如 " "），可补充 typeof value === 'string' && value.trim() === '' 判断。
总结：JSON.stringify + replacer 是清理 JSON 中 null 和 '' 的最简洁、可靠、递归友好的方案。它以声明式逻辑替代复杂递归遍历，在保持代码可读性的同时，精准达成深度净化目标。
