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 看似只是美化，但实际会影响日志可读性、网络传输体积，甚至某些后端解析行为（比如严格模式下不接受尾随逗号，而缩进格式更容易暴露这类问题）。
立即学习“Java免费学习笔记（深入）”；
- 传
2最常用，适合开发环境查看结构；传4或" "也行，但别用中文空格或全角字符 - 生产环境一般用
0或省略，减少体积；但若需人肉排查接口响应，临时加2很有用 - 传字符串时，长度超过 10 会被截断，且每个层级都重复该字符串，例如
JSON.stringify({a:1}, null, "→ ")会生成带箭头缩进的结果
