JavaScript处理JSON的核心是JSON.parse()和JSON.stringify(),前者要求严格双引号格式、禁止单引号/尾逗号/undefined等,需try-catch防护;后者会隐式丢弃undefined/function/Symbol,对Date/RegExp/NaN等有特殊转换规则,BigInt、Map、Set需手动处理,推荐封装safeParse/safeStringify并结合schema校验。

JavaScript 处理 JSON 数据的核心是 JSON.parse() 和 JSON.stringify(),但看似简单,实际使用中容易踩坑。关键不是“会不会用”,而是“什么能转、什么不能转、哪里会静默失败”。
JSON.parse() 解析时的常见陷阱
它只接受**严格格式的字符串**,多一个逗号、少一个引号、用了单引号或 undefined 都会直接报错。
- 键名和字符串值必须用双引号包裹,单引号或不加引号会报错:
{"name": 'Alice'}❌,{"name": "Alice"}✅ - 尾部逗号(trailing comma)不被允许:
{"a": 1, "b": 2,}❌ -
undefined、function、Symbol、BigInt无法出现在原始 JSON 字符串中,否则解析失败 - 推荐加 try-catch 包裹,避免因后端返回脏数据导致页面崩溃:
try { const data = JSON.parse(str); } catch (e) { console.error("JSON 解析失败", e.message); }
JSON.stringify() 序列化时的隐式丢弃行为
它不是“把对象转成字符串”那么简单,而是一套有明确过滤规则的序列化过程。
-
自动忽略:
undefined、function、Symbol类型的属性值(连同整个键值对一起消失) -
跳过:循环引用的对象会抛出
TypeError: Converting circular structure to JSON -
转换:
Date对象变成 ISO 字符串,RegExp变成空对象{},NaN和Infinity变成null - 可传入第二个参数
replacer函数或数组,定制哪些字段保留:JSON.stringify(obj, ['name', 'age'])只保留 name 和 age 字段
处理特殊值:日期、BigInt、Map、Set 的方案
原生 JSON 不支持这些类型,需手动干预。
立即学习“Java免费学习笔记(深入)”;
-
Date:序列化前转为字符串(如
date.toISOString()),解析后用new Date(str)恢复 -
BigInt:
JSON.stringify(123n)直接报错;可用replacer转为字符串并加标识,如{_type: 'bigint', value: '123'},解析时再判断还原 -
Map / Set:先转为普通对象或数组,例如:
JSON.stringify([...myMap])或JSON.stringify(Array.from(mySet)) - 更通用的做法是封装自己的
safeParse和safeStringify工具函数,统一处理业务中常见的非标类型
前后端联调时的典型问题
很多 bug 不是代码写错,而是约定没对齐。
- 后端返回的字段名是小驼峰,前端习惯下划线?——别靠 JS 改名,让接口统一,或在解析后做一次映射(用工具函数)
- 后端可能返回
"null"字符串(注意是字符串!),而非真正的null值,JSON.parse()不会帮你识别,需要额外校验 - 接口文档写的是
{"code":0,"data":{...}},结果某次返回{"code":0,"result":{...}}——建议用 TypeScript + 运行时 schema 校验(如 zod)提前拦截结构异常
基本上就这些。JSON 处理不复杂,但容易忽略边界情况。养成加 try-catch、查类型、看原始字符串的习惯,比记住语法更重要。










