javascript JSON如何序列化与解析_有哪些注意事项？_技术教程

JSON.stringify() 无法处理函数、undefined、Symbol 和循环引用，会静默丢弃或抛错；JSON.parse() 仅支持标准 JSON 格式，对语法极其敏感；Date、BigInt、Map/Set 等需手动转换；解析不可信输入是安全的，但不可替代 eval。

JSON.stringify() 不能处理函数、undefined、Symbol 和循环引用

直接调用 JSON.stringify() 序列化对象时，遇到函数、undefined、Symbol 值或对象内部存在循环引用，会静默丢弃或抛错。比如：

const obj = {
  name: "Alice",
  fn: () => {},
  id: undefined,
  sym: Symbol("key"),
  self: null
};
obj.self = obj;
JSON.stringify(obj); // '{"name":"Alice","self":{}}' —— fn、id、sym 全没了，且循环引用被截断成空对象

function 和 undefined 字段被完全忽略（不报错）
Symbol 键名和键值均不可序列化，会被跳过
循环引用会导致 TypeError: Converting circular structure to JSON（除非提前断开）
如果需要保留函数逻辑，得先手动转为字符串或用其他序列化方案（如 serialize-javascript）

JSON.parse() 对输入格式极其敏感，空白和引号必须严格符合规范

JSON.parse() 不是“宽松解析器”，它只接受标准 JSON 格式：双引号、无尾逗号、无单引号、无注释、数字不能以 0 开头（如 0123）。常见失败场景：

JSON.parse("{name: 'Alice'}"); // SyntaxError —— 单引号 + 未引号的 key
JSON.parse('{"age": 0123}');   // SyntaxError —— 八进制字面量不合法
JSON.parse('{"msg": "hi",}');   // SyntaxError —— 尾逗号不允许
JSON.parse('{"data": null }');  // ✅ 正确（注意：null 是合法 JSON 值）

前端接收后端响应时，务必确认 Content-Type 是 application/json，且响应体是纯 JSON 字符串（不是 HTML 包裹的 JSON）
从 localStorage 读取时，先做非空和格式校验：try { JSON.parse(str) } catch (e) { /* 处理解析失败 */ }
不要用 JSON.parse() 解析用户输入的任意文本——它不是通用数据解析工具

日期、BigInt、Map/Set 等类型需手动转换

原生 JSON.stringify() 和 JSON.parse() 不支持 Date、BigInt、Map、Set 等类型，序列化后信息丢失或报错：

JSON.stringify(new Date());     // '"2025-05-20T08:12:34.567Z"' —— 变成字符串，但反解析得不到 Date 实例
JSON.stringify(123n);          // TypeError: Do not know how to serialize a BigInt
JSON.stringify(new Map([['a', 1]])); // '{}' —— 空对象

日期建议统一转为 ISO 字符串，并在解析后用 new Date(str) 恢复
BigInt 需显式转为字符串（String(123n)），解析后再用 BigInt(str) 还原；注意 JSON.stringify() 第二个参数（replacer）可拦截处理
Map/Set 推荐先转为数组：Array.from(map) 或 [...map]，解析后再重建实例
自定义类实例默认只序列化其可枚举属性，原型方法和私有字段（#field）不会出现

安全风险：不要用 JSON.parse() 替代 eval() 来执行代码

有人误以为 JSON.parse('{ "x": console.log(1) }') 能执行语句，但这是错的——JSON 不支持表达式，上面这行会直接报语法错误。真正危险的是用 eval() 或 Function() 解析不可信输入，而 JSON 解析本身是安全的（只要输入确实是 JSON）。

如果后端返回的是 JSONP 或带前缀的 JSON（如 callback({...})），不能直接传给 JSON.parse()
从 URL 参数、location.hash 或第三方 API 拿到的字符串，必须先清洗或验证结构，再解析
Node.js 中若用 require('./config.json')，本质是 Node 的 JSON 加载器，它比 JSON.parse() 更宽松（允许注释、尾逗号），但仅限于 require 场景，不可混用

实际项目中，最常被忽略的是循环引用检测和日期还原逻辑——它们往往在特定数据结构下才暴露，上线后难复现。