如何去掉json空值

告别“空”的烦恼：全面解析如何高效去除 JSON 中的空值

在现代软件开发中,JSON（JavaScript Object Notation）已成为数据交换的事实标准，无论是前后端数据交互、API 响应，还是配置文件，我们都离不开它，一个常见且令人头疼的问题就是 JSON 数据中夹杂的空值，null、空字符串、空数组 [] 或空对象，这些“空”数据不仅会增加网络传输的负担，还可能导致前端渲染错误或后端处理逻辑的混乱。

学会如何高效、优雅地去除 JSON 中的空值，是每一位开发者必备的技能，本文将带你探讨这个问题，从概念到实践，覆盖多种编程语言和场景。

为什么需要去除 JSON 空值？

在动手之前,我们首先要明确“为什么要做”，去除空值主要有以下几个核心原因：

减小数据体积：去除冗余的空值可以显著减小 JSON 字符串的长度，从而减少网络传输的数据量，提升 API 响应速度和前端加载性能。
简化数据处理逻辑：接收方（无论是前端还是后端）无需编写额外的 null 或 undefined 检查逻辑，代码会更简洁、健壮，降低因处理空值而引发的潜在错误。
提升数据可读性：一个干净、精简的 JSON 数据结构更易于人类阅读和理解，尤其在调试和日志分析时。
满足特定 API 规范：某些 API 设计要求只发送有实际意义的字段，空值是不被允许的。

什么是“空值”？—— 定义你的清理目标

“空值”的定义并非一成不变，它取决于你的业务需求，在开始编码前，你必须明确：哪些值需要被移除？

常见的“空值”包括：

null：JavaScript 中的 null 值。
空字符串。
[]：空数组。
空对象。
undefined：未定义的值（在某些序列化场景下可能出现）。

你可能只想移除 null 和空字符串，而希望保留空数组（因为它可能表示一个有效的“无元素”列表），第一步永远是明确你的过滤规则。

实践出真知：在不同语言中去除 JSON 空值

下面我们来看几种主流编程语言中,如何实现 JSON 空值的过滤。

JavaScript / Node.js

JavaScript 处理 JSON 数据最为直接，通常结合数组的 filter() 和 reduce() 方法。

过滤一个简单的对象

假设我们有如下 JSON 对象：

{
  "name": "Alice",
  "age": null,
  "email": "",
  "hobbies": [],
  "address": null,
  "contact": {
    "phone": "123-456-7890",
    "fax": null
  }
}

方法 1：使用 reduce() 遍历对象属性

这是最通用的方法,可以自定义过滤逻辑。

const jsonData = {
  "name": "Alice",
  "age": null,
  "email": "",
  "hobbies": [],
  "address": null,
  "contact": {
    "phone": "123-456-7890",
    "fax": null
  }
};
// 定义一个函数来递归地清理对象
function removeEmptyValues(obj) {
  // 1. 过滤掉值为 null 或 "" 的顶层属性
  const cleanedObj = Object.fromEntries(
    Object.entries(obj).filter(([_, value]) => value !== null && value !== "")
  );
  // 2. 递归处理嵌套对象
  for (const key in cleanedObj) {
    if (typeof cleanedObj[key] === 'object' && cleanedObj[key] !== null) {
      // 如果是数组，可以过滤掉空数组，或者继续递归处理数组里的对象
      if (Array.isArray(cleanedObj[key])) {
        // 示例：过滤掉空数组
        if (cleanedObj[key].length === 0) {
          delete cleanedObj[key];
        } else {
          // 如果数组里还有对象，可以继续递归
          cleanedObj[key] = cleanedObj[key].map(item => 
            typeof item === 'object' ? removeEmptyValues(item) : item
          ).filter(item => item !== null && item !== ""); // 过滤掉数组里的空值
        }
      } else {
        // 如果是对象，递归调用
        cleanedObj[key] = removeEmptyValues(cleanedObj[key]);
      }
    }
  }
  return cleanedObj;
}
const cleanedData = removeEmptyValues(jsonData);
console.log(JSON.stringify(cleanedData, null, 2));

输出结果：

{
  "name": "Alice",
  "hobbies": [],
  "contact": {
    "phone": "123-456-7890"
  }
}

注意：上面的代码保留了空数组 []，因为它只过滤了 null 和，如果你也想移除空数组，只需在 filter 条件中加入 value !== [] 即可。

方法 2：使用第三方库（如 lodash）

对于复杂项目,使用成熟的库是更高效、更可靠的选择。lodash 提供了 _.omitBy 和 _.isEmpty 方法，组合使用非常方便。

npm install lodash

const _ = require('lodash');
const jsonData = { /* ... 同上 ... */ };
// 使用 lodash 的 omitBy 和 isEmpty
// isEmpty 可以判断 null, "", [], {}, 0, false 等
const cleanedData = _.omitBy(jsonData, _.isEmpty);
console.log(JSON.stringify(cleanedData, null, 2));

输出结果：

{
  "name": "Alice",
  "contact": {
    "phone": "123-456-7890"
  }
}

lodash 的 isEmpty 非常强大，它会移除所有“空”值，你可以根据需要自定义判断逻辑。

Python

Python 中，我们可以使用字典推导式和递归来实现，也可以借助第三方库。

过滤一个简单的字典

import json
json_data = {
    "name": "Bob",
    "age": None,
    "email": "",
    "hobbies": [],
    "address": None,
    "contact": {
        "phone": "987-654-3210",
        "fax": None
    }
}
def remove_empty_values(d):
    if not isinstance(d, dict):
        return d
    # 使用字典推导式过滤掉值为 None 或 "" 的键
    cleaned_dict = {k: v for k, v in d.items() if v is not None and v != ""}
    # 递归处理嵌套的字典和列表
    for key, value in cleaned_dict.items():
        if isinstance(value, dict):
            cleaned_dict[key] = remove_empty_values(value)
        elif isinstance(value, list):
            # 过滤掉列表中的空字典或空列表
            cleaned_dict[key] = [
                remove_empty_values(item) if isinstance(item, dict) else item
                for item in value if item not in (None, "", [], {})
            ]
    return cleaned_dict
cleaned_data = remove_empty_values(json_data)
print(json.dumps(cleaned_data, indent=2))

输出结果：

{
  "name": "Bob",
  "hobbies": [],
  "contact": {
    "phone": "987-654-3210"
  }
}

方法 2：使用第三方库（如 jsons）

pip install jsons

import json
from jsons import strip_nulls
json_data = { /* ... 同上 ... */ }
# strip_nulls 函数可以方便地移除 None 值
cleaned_data = strip_nulls(json_data)
# 注意：strip_nulls 默认不处理空字符串 "", 需要结合其他方法
# 可以自定义一个 stripper
def strip_empty_values(obj):
    if isinstance(obj, dict):
        return {k: strip_empty_values(v) for k, v in obj.items() if v not in (None, "", [], {})}
    elif isinstance(obj, list):
        return [strip_empty_values(v) for v in obj if v not in (None, "", [], {})]
    return obj
cleaned_data = strip_empty_values(json_data)
print(json.dumps(cleaned_data, indent=2))