
本文介绍使用 javascript 的 `json.stringify` 配合自定义 `replacer` 函数,递归移除 json 中值为 `null` 或空字符串(`''`)的键值对,并深度清理“全空对象”(即所有子属性均被过滤后为空的对象)。
在处理嵌套 JSON 数据时,常需剔除无效字段——如 null、空字符串 "",甚至进一步删除因此变得“空洞”的对象(例如 { "src": null, "name": null, "alignment": null } 应整体移除)。仅靠简单 replacer 过滤原始值(如 value === null || value === '' ? undefined : value)虽能清除叶子节点,但无法自动删除已变为空的对象,因为 JSON.stringify 默认不会递归塌缩空对象。
✅ 正确方案需两步协同:
- 第一遍序列化 + replacer:过滤 null 和 "";
- 第二遍解析 + 深度清理:用 JSON.parse 配合 reviver,自底向上判断每个对象是否为空(Object.keys(obj).length === 0),若为空则返回 undefined,触发父级删除。
以下是完整、健壮的实现:
function cleanJson(obj) {
// 第一步:过滤 null 和空字符串
const cleaned = JSON.parse(
JSON.stringify(obj, (key, value) => {
// 排除 null 和空字符串(注意:0、false、[]、{} 等有效值保留)
if (value === null || value === '') return undefined;
return value;
})
);
// 第二步:递归移除空对象(包括 {}、{a: {}, b: null} → {b: null} 后 a 被删,最终可能变 {} → 再删)
function removeEmpty(obj) {
if (obj === null || typeof obj !== 'object') return obj;
if (Array.isArray(obj)) {
return obj.map(removeEmpty).filter(item => item !== undefined);
}
const result = {};
for (const [key, val] of Object.entries(obj)) {
const cleanedVal = removeEmpty(val);
if (cleanedVal !== undefined) {
result[key] = cleanedVal;
}
}
// 若当前对象无任何有效属性,返回 undefined(触发上级删除)
return Object.keys(result).length === 0 ? undefined : result;
}
return removeEmpty(cleaned);
}
// 使用示例
const input = {
"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(JSON.stringify(cleanJson(input), null, 2));? 关键注意事项:
- ✅ 该方法保留所有非空原始值:0、false、"0"、" "(带空格)、[]、{}(若未被清空)均不误删;
- ⚠️ replacer 中避免直接 typeof value === 'object' && !value 判断,因 null 是 object 类型,易引发逻辑错误;
- ? 清理是深度优先、自底向上:先清理最深层子对象,再逐层向上判断是否变空;
- ? 如需扩展“空值”定义(如过滤 undefined、空白字符串 /\s+/、空数组 []),可在 removeEmpty 内部增强判断逻辑。
此方案兼顾简洁性与鲁棒性,适用于任意深度嵌套的配置数据清洗场景。










