如何递归清理 JSON 中所有 null 和空字符串值的键及其空对象

本文介绍使用 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 和 ” 的最简洁、可靠、递归友好的方案。它以声明式逻辑替代复杂递归遍历，在保持代码可读性的同时，精准达成深度净化目标。