什么是JSON以及如何在javascript中解析和序列化数据【教程】

JSON是严格语法的字符串格式,非JS对象;JSON.parse()和JSON.stringify()是核心工具,需用try/catch安全解析,且不支持函数、unde

fined、循环引用等不可序列化值。

JSON 不是 JavaScript 的专属格式,但它是 JS 中最常用的数据交换格式;JSON.parse()JSON.stringify() 就是全部核心工具,不需要额外库。

JSON 是什么:不是对象,是字符串格式

很多人误以为 { "name": "Alice" } 就是 JSON —— 实际上,这只是 JS 对象字面量。真正的 JSON 必须是字符串,且有严格语法限制:键名必须双引号、不能有单引号、不允许尾逗号、不支持函数或 undefinedDate 等非数据类型。

常见错误现象:

  • JSON.parse("{ name: 'Alice' }") → 报错:SyntaxError: Unexpected token n(键没引号)
  • JSON.parse('{"age": }') → 报错:SyntaxError: Unexpected token }(值缺失)
  • JSON.stringify({ time: new Date() }) → 返回 "{"time":"2025-01-01T00:00:00.000Z"}"Date 被自动转为 ISO 字符串)

JSON.parse() 安全解析字符串

它只接受合法 JSON 字符串,遇到非法输入直接抛错。生产环境务必加 try/catch

使用场景:处理 API 响应、读取本地配置文件、解析用户输入的 JSON 文本。

实操建议:

  • 永远不要省略 try/catch,尤其当字符串来自外部(如 fetch().then(r => r.text())
  • 若需自定义转换逻辑(如把字符串日期转为 Date 对象),用第二个参数 reviver 函数
  • JSON.parse("null") 合法,返回 nullJSON.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 值

它只处理可序列化的值:基本类型、数组、普通对象。遇到函数、undefinedSymbol、循环引用会静默忽略或报错。

参数差异:

  • 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": "2025-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