JSON.parse()将JSON字符串转为JavaScript对象,JSON.stringify()将其转回字符串;二者不互逆,Date、NaN等类型会丢失或出错,使用时需校验输入并处理边界情况。

JSON.parse 把字符串转成 JavaScript 对象
当你从接口拿到响应、读取本地存储或解析配置文件时,数据通常是字符串形式的 JSON,比如 "{\"name\":\"Alice\",\"age\":30}"。直接用它会报错,因为 JS 不认识这种格式的字符串。
这时候必须用 JSON.parse() 转成真正的对象才能访问属性:
const str = '{"name":"Alice","age":30}';
const obj = JSON.parse(str);
console.log(obj.name); // "Alice"
- 如果字符串格式非法(比如多了一个逗号、用了单引号、缺少引号),
JSON.parse()会直接抛出SyntaxError - 它不执行代码,也不解析函数、
undefined、Date对象等非标准 JSON 类型——这些都会被忽略或报错 - 可以传入第二个参数
reviver函数,在解析过程中过滤或转换字段值
JSON.stringify 把 JavaScript 值转成 JSON 字符串
向后端发请求、存入 localStorage、记录日志时,往往需要把对象变成字符串。但 toString() 或模板字符串都不行,它们输出的是 JS 表示法,不是标准 JSON。
JSON.stringify() 是唯一安全通用的序列化方式:
立即学习“Java免费学习笔记(深入)”;
const obj = { name: "Alice", age: 30 };
const str = JSON.stringify(obj);
console.log(str); // '{"name":"Alice","age":30}'
- 会自动跳过
undefined、函数、Symbol 类型的键值对 - 遇到循环引用(比如对象 A 的属性指向自身)会直接抛出
TypeError - 支持第三个参数控制缩进(如
2或" "),方便调试输出 - 第二个参数可以是数组(指定要保留的键名)或函数(自定义序列化逻辑)
parse 和 stringify 不是互逆的——尤其注意 Date 和 NaN
很多人以为 JSON.parse(JSON.stringify(x)) 总能还原原值,其实不行。最典型的是 Date 对象:
const d = new Date(); const str = JSON.stringify(d); // '"2024-05-12T08:30:45.123Z"' const parsed = JSON.parse(str); // 字符串,不是 Date 实例
-
new Date(parsed)可以补救,但得手动做 -
NaN、Infinity、-Infinity经过stringify后变成null -
undefined作为对象属性值会被忽略;作为数组元素则变成null - 正则表达式、Map、Set、Buffer 等原生类型无法被原样序列化
实际开发中容易漏掉的边界情况
线上 bug 很多来自没校验 parse 的输入或没处理 stringify 的失败场景。
- 别直接
JSON.parse(localStorage.getItem("user"))—— 如果值是null或空字符串,会报错。先判断再解析 - 后端返回的 JSON 可能带 BOM 或不可见控制字符,导致
parse失败;可以用str.trim().replace(/^\uFEFF/, '')预处理 - 想深拷贝对象?
JSON.parse(JSON.stringify(obj))最快但有缺陷;需要保类型就用 structuredClone(现代环境)或专门的库 - 服务端返回
204 No Content时,响应体为空,JSON.parse("")必然失败
真正麻烦的从来不是语法,而是那些看似合法、实则含糊的字符串输入,以及你以为“只是临时用一下”的隐式转换。










