17370845950

JSON.stringify(value, replacer, space) 有三个参数：replacer可为数组（精确匹配首层字段）或函数（处理函数/undefined/Symbol、循环引用等），space控制缩进（数字或字符串，0/""/false生成紧凑格式）。

JSON.stringify 的基本用法和两个可选参数

直接调用 JSON.stringify(obj) 能把大多数普通对象转成 JSON 字符串，但遇到函数、undefined、Symbol、循环引用会出问题。它实际支持三个参数：JSON.stringify(value, replacer, space)，其中后两个是可选的。

• replacer 可以是数组（指定要保留的属性名）或函数（自定义序列化逻辑），传 null 或不传表示不过滤
• space 控制缩进，可以是数字（空格数）或字符串（如 "\t"），传 0、"" 或 false 会生成紧凑格式（无换行无空格）
• 注意：replacer 函数中 this 指向父级对象，返回 undefined 会排除当前键，返回其他值则使用该值替代原值

replacer 数组用法：只保留指定字段

当只需要导出对象的某些字段时，用字符串数组最简洁。数组里写的字段名必须完全匹配，大小写敏感，且不会递归生效——只作用于第一层。

const user = { name: "Alice", age: 30, token: "abc123", role: "admin" };
console.log(JSON.stringify(user, ["name", "age"], 2));
// 输出：
// {
//   "name": "Alice",
//   "age": 30
// }

• 如果数组里写了不存在的字段（如 ["email"]），对应字段不会出现在结果中，也不会报错
• 嵌套对象的字段不会被这个顶层 replacer 影响，除非你在 replacer 函数里手动处理
• 不能用正则或通配符，只能精确列出字段名

replacer 函数用法：跳过函数/undefined/Symbol，处理循环引用

默认情况下，JSON.stringify 遇到函数、undefined、Symbol 会静默丢弃；遇到循环引用直接抛错 TypeError: Converting circular structure to JSON。用 replacer 函数可以拦截并转换这些值。

const obj = { a: 1, b: () => {}, c: undefined, d: Symbol("x") };
const seen = new WeakMap();

function replacer(key, value) {
  if (typeof value === "function" || value === undefined || typeof value === "symbol") {
    return null; // 统一转成 null，避免被删掉
  }
  if (typeof value === "object" && value !== null) {
    if (seen.has(value)) return "[Circular]";
    seen.set(value, true);
  }
  return value;
}

console.log(JSON.stringify(obj, replacer));
// {"a":1,"b":null,"c":null,"d":null}

• 必须自己管理循环引用检测，WeakMap 是常用方式；JSON.stringify 不内置此功能
• 返回 undefined 会导致整个键被忽略（不是变成 null），这点容易误判
• 对 Date、RegExp 等内置对象，replacer 函数能拿到它们的原始值，可手动转成字符串（如 value instanceof Date ? value.toISOString() : value）

space 参数影响输出格式和调试体验

space 看似只是美化，但实际会影响日志可读性、网络传输体积，甚至某些后端解析行为（比如严格模式下不接受尾随逗号，而缩进格式更容易暴露这类问题）。

• 传 2 最常用，适合开发环境查看结构；传 4 或 "  " 也行，但别用中文空格或全角字符
• 生产环境一般用 0 或省略，减少体积；但若需人肉排查接口响应，临时加 2 很有用
• 传字符串时，长度超过 10 会被截断，且每个层级都重复该字符串，例如 JSON.stringify({a:1}, null, "→ ") 会生成带箭头缩进的结果