JSON是严格语法的字符串格式,非JS对象;JSON.parse()和JSON.stringify()是核心工具,需用try/catch安全解析,且不支持函数、undefined、循环引用等不可序列化值。

JSON 不是 JavaScript 的专属格式,但它是 JS 中最常用的数据交换格式;JSON.parse() 和 JSON.stringify() 就是全部核心工具,不需要额外库。
JSON 是什么:不是对象,是字符串格式
很多人误以为 { "name": "Alice" } 就是 JSON —— 实际上,这只是 JS 对象字面量。真正的 JSON 必须是字符串,且有严格语法限制:键名必须双引号、不能有单引号、不允许尾逗号、不支持函数或 undefined、Date 等非数据类型。
常见错误现象:
-
JSON.parse("{ name: 'Alice' }")→ 报错:SyntaxError: Unexpected token n(键没引号) -
JSON.parse('{"age": }')→ 报错:SyntaxError: Unexpected token }(值缺失) -
JSON.stringify({ time: new Date() })→ 返回"{"time":"2024-01-01T00:00:00.000Z"}"(Date被自动转为 ISO 字符串)
用 JSON.parse() 安全解析字符串
它只接受合法 JSON 字符串,遇到非法输入直接抛错。生产环境务必加 try/catch。
立即学习“Java免费学习笔记(深入)”;
使用场景:处理 API 响应、读取本地配置文件、解析用户输入的 JSON 文本。
实操建议:
- 永远不要省略
try/catch,尤其当字符串来自外部(如fetch().then(r => r.text())) - 若需自定义转换逻辑(如把字符串日期转为
Date对象),用第二个参数reviver函数 -
JSON.parse("null")合法,返回null;JSON.parse("")报错
try {
const data = JSON.parse('{"user":{"id":123,"name":"Bob"}}');
console.log(data.user.name); // "Bob"
} catch (err) {
console.error("JSON 解析失败:", err.message);
}
用 JSON.stringify() 序列化 JS 值
它只处理可序列化的值:基本类型、数组、普通对象。遇到函数、undefined、Symbol、循环引用会静默忽略或报错。
参数差异:
-
JSON.stringify(obj):默认紧凑输出 -
JSON.stringify(obj, null, 2):第二个参数是replacer(可过滤/改写字段),第三个是缩进空格数(用于美化) -
JSON.stringify(undefined)→undefined(不是字符串"undefined") -
JSON.stringify([1, undefined, 2])→"[1,null,2]"(undefined被转为null)
const obj = { id: 42, name: "Tom", createdAt: new Date() };
console.log(JSON.stringify(obj, null, 2));
// 输出:
// {
// "id": 42,
// "name": "Tom",
// "createdAt": "2024-01-01T00:00:00.000Z"
// }
容易被忽略的边界情况
真正出问题的地方往往不在语法,而在数据结构本身:
- 循环引用对象(如
a.b = b; b.a = a;)→TypeError: Converting circular structure to JSON -
BigInt值(如123n)→ 直接报错,需手动在replacer中处理 - 带 getter 的对象属性 →
JSON.stringify不触发 getter,只序列化自有可枚举属性 -
正则表达式、
Error对象 → 序列化后变成空对象{}
如果业务中频繁遇到这些,说明该考虑用更健壮的序列化方案(如 flatted 处理循环引用,或自定义序列化函数),而不是硬套 JSON.stringify。











