JSON.stringify实用技巧与避坑全解析

JSON.stringify()表面简单，实则暗藏诸多陷阱：日期自动转为ISO字符串导致类型丢失、函数和undefined被静默删除、Symbol属性完全不可见、循环引用直接抛错、BigInt原生不支持而报错，再加上空格缩进、Unicode编码和数组中undefined转null等细节问题——稍不留意就会引发数据丢失或运行时错误。掌握replacer预处理、合理封装序列化函数、针对性处理Date/BigInt/循环引用等边界情况，才能真正安全、可靠地完成JavaScript对象的序列化任务。

JavaScript中JSON.stringify()看似简单，但实际使用时容易踩坑——比如日期变空对象、函数丢失、循环引用报错、undefined被忽略、BigInt报错等。掌握这些边界情况，才能安全可靠地序列化对象。

日期对象会变成ISO字符串，不是原始Date实例

JSON.stringify()自动将Date对象转为ISO格式字符串（如"2024-05-20T08:30:00.000Z"），反序列化后是字符串而非Date。若需保留日期类型，得手动处理：

• 序列化前用toJSON()方法自定义输出（Date原生支持该方法）
• 或在replacer函数中识别Date并转成时间戳：typeof value === 'object' && value instanceof Date ? value.getTime() : value
• 反序列化后，再根据字段名或值特征把字符串/数字重新转为Date

函数、undefined、Symbol 和 循环引用直接被忽略或报错

默认行为下：

• 函数和undefined字段会被静默删除（不报错，但数据丢失）
• Symbol键名的属性完全不可见（连replacer也收不到）
• 遇到对象循环引用（如obj.a = obj）会抛出TypeError: Converting circular structure to JSON

应对方式：用replacer预处理过滤非法值；对循环引用，可借助第三方库（如flatted）或自行实现引用标记逻辑（例如用WeakMap记录已遍历对象）。

BigInt 类型直接报错，必须显式转换

JSON.stringify({x: 1n})会抛出TypeError: Do not know how to serialize a BigInt。不能依赖默认行为，必须主动转换：

• 在replacer中检测typeof value === 'bigint'，返回value.toString()（推荐）或Number(value)（注意精度丢失风险）
• 避免全局替换，只对明确含BigInt的字段做处理，防止误转其他数字

空格与换行影响可读性，但不影响语义；特殊字符需注意编码

JSON.stringify(obj, null, 2)加缩进便于调试，但生产环境建议省略（减小体积）。另外：

• 中文、emoji 等 Unicode 字符会被正确编码（如"你好" → "\\u4f60\\u597d"），无需额外处理
• 若后端要求严格 ASCII，可用JSON.stringify(obj, null, 0).replace(/[\u007F-\uFFFF]/g, ...)二次转义（极少需要）
• undefined作为数组元素时变成null（JSON.stringify([1, undefined, 3]) → [1,null,3]），这点常被忽略

不复杂但容易忽略——关键是在序列化前想清楚：哪些字段必须保留、哪些要过滤、哪些需转换类型、是否涉及循环或特殊值。加一层薄薄的封装函数，就能避开大多数陷阱。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《JSON.stringify实用技巧与避坑全解析》文章吧，也可关注golang学习网公众号了解相关技术文章。