JavaScript解析与序列化JSON教程

JavaScript中JSON操作看似只有JSON.parse()和JSON.stringify()两个简单方法，实则暗藏大量易被忽视的陷阱：非字符串输入、BOM字符、循环引用、特殊值（函数/undefined/Symbol）静默丢失、Date序列化歧义，以及严格JSON规范（双引号、无尾逗号）与常见误用（如单引号、JSON5语法）的冲突；真正决定成败的不是语法本身，而是对数据来源的真实性校验、边界情况的主动防御，以及善用replacer/reviver这一安全扩展机制实现类型归一化——这些实战经验，远比记住API签名更重要。

JavaScript 里操作 JSON 几乎没有“教程”这回事——JSON.parse() 和 JSON.stringify() 就是全部核心，但用错地方、传错参数、忽略边界情况，才是实际出问题的根源。

JSON.parse() 报错：Unexpected token 或 Unexpected end of JSON input

这是最常见的解析失败，本质不是语法错误，而是传入了非字符串、空值、或带 BOM/不可见字符的字符串。

• JSON.parse(null) 或 JSON.parse(undefined) 直接抛 TypeError；必须确保输入是 string 类型，可用 typeof input === 'string' && input.trim() 防御
• 后端返回空响应体（""）或只含空白符（"\n\t "），JSON.parse(" ") 会报 Unexpected token
• 某些 API 返回带 UTF-8 BOM 的 JSON（如 \ufeff{"a":1}），需先用 str.replace(/^\uFEFF/, '') 清除
• 不要对已解析对象再调用 JSON.parse()，比如 JSON.parse(JSON.parse('{"x":1}')) 必然失败

JSON.stringify() 输出 undefined、null 或丢失数据

JSON.stringify() 不是无损序列化工具，它有明确的忽略规则和类型限制。

• 函数、undefined、Symbol 值会被**静默丢弃**：JSON.stringify({a: 1, b: () => {}, c: undefined}) → "{"a":1}"
• 循环引用直接抛 TypeError: Converting circular structure to JSON，不能靠 try/catch 挺过去，得提前检测或用自定义 replacer 处理
• Date 对象被转成 ISO 字符串，但 new Date().toJSON() 和 JSON.stringify(new Date()) 行为一致；若需保留时间戳数字，要用 replacer 参数干预
• JSON.stringify(undefined) 返回 undefined（不是字符串 "undefined"），常导致拼接时意外变成 "foo" + JSON.stringify(undefined) + "bar" → "foobar"

需要处理特殊值？别硬改 JSON，用 replacer 和 reviver

这两个参数是 JSON.stringify() 和 JSON.parse() 唯一合法的扩展点，比写正则或手动遍历安全得多。

• JSON.stringify(obj, (key, val) => key === 'date' ? val.getTime() : val) 可把 Date 转时间戳
• JSON.parse(str, (key, val) => key === 'ts' ? new Date(val) : val) 可把数字时间戳还原为 Date
• 注意：reviver 中的 this 指向父对象，且对顶层对象也调用一次（key 为空字符串），要加判断避免误处理
• replacer 传数组可白名单字段：JSON.stringify(obj, ['id', 'name'])，比传函数更轻量

浏览器和 Node.js 的兼容性基本不用操心，但要注意 JSON5 不是 JSON

ES5 就已内置 JSON 全局对象，所有现代环境都支持。真正容易混淆的是：有人拿 JSON5（支持注释、单引号、尾逗号）当 JSON 用，结果在生产环境崩。

• JSON.parse('{ "a": 1, }') 在严格 JSON 下报错；JSON5 才允许尾逗号
• JSON.parse("{'a': 1}") 同样非法——JSON **只认双引号**，单引号是常见误判点
• Node.js 里 require('./config.json') 是 CommonJS 行为，底层调用的是 fs.readFileSync + JSON.parse，所以依然受 JSON 规范约束

真正难的从来不是“怎么调用”，而是你拿到的数据到底是不是 JSON 字符串、有没有被中间层悄悄改过格式、以及要不要在序列化前后做类型归一化——这些没法靠查文档解决，得看 network 面板、打日志、甚至抓包确认原始 payload。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。