JavaScript中对象序列化JSON-stringify的避坑指南-js教程-PHP中文网

JSON.stringify()易踩坑：日期变ISO字符串、函数/undefined被删、Symbol不可见、循环引用报错、BigInt需手动转字符串；需用replacer预处理，封装函数可规避多数问题。

javascript中对象序列化json-stringify的避坑指南

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记录已遍历对象）。

jm-jsjkxyjs02-zlm-405

使用约定式提交（Conventional Commits）生成标准化的 Git 提交信息。适用于以下场景： (1) 暂存更改时需要提交信息； (2) 审查 diff 时希望获得结构化摘要； (3) 编写 PR 描述或变更日志（changelog）条目； (4) 用户明确要求“为本次更改编写提交信息”。该功能会分析已暂存/未暂存的 diff，并生成按类型（type）划分范围的提交信息。

下载

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]），这点常被忽略

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