localStorage只能存字符串，直接存储对象会调用toString()变为"[object Object]"；必须用JSON.stringify()序列化、JSON.parse()反序列化，并注意undefined、函数、Date等特殊类型的处理限制。
localStorage 只能存字符串，直接 setItem 一个对象会变成 [object Object]，必须手动序列化。
为什么不能直接存对象？
localStorage 的底层 API 设计就是键值对字符串存储，所有非字符串值都会被隐式调用 toString()。比如：
localStorage.setItem('user', { name: 'Alice' });
console.log(localStorage.getItem('user')); // "[object Object]"
这不是 bug，是规范行为。所以必须显式转换为 JSON 字符串。
JSON.stringify() 是最常用且安全的序列化方式
它能把大多数普通对象、数组、基础类型组合转成合法 JSON 字符串，且浏览器原生支持、无依赖、性能好。
立即学习“前端免费学习笔记（深入）”；
- 支持嵌套对象、数组、数字、字符串、布尔、
null - 不支持
undefined、函数、Date（会变null）、RegExp、Symbol、循环引用 - 遇到不支持的字段会静默丢弃（例如：
JSON.stringify({ a: undefined, b: 1 })→"{"b":1}"）
典型用法：
const user = { name: 'Alice', age: 28, isActive: true };
localStorage.setItem('user', JSON.stringify(user));
取出来时必须用 JSON.parse() 反序列化
存进去的是字符串，取出来还是字符串，不 parse 就只是文本，不是对象。
- 忘记
JSON.parse()是最常见错误，会导致后续调用.name报TypeError: Cannot read property 'name' of null - 建议加
try/catch，因为用户可能手动改过 localStorage，导致 JSON 格式损坏
const userStr = localStorage.getItem('user');
let user = null;
try {
user = JSON.parse(userStr);
} catch (e) {
console.error('解析 localStorage 中的 user 失败', e);
}
复杂对象（如 Date、Map、Set）需要自定义序列化逻辑
JSON.stringify() 对 Date 默认只输出字符串（如 "2023-01-01T00:00:00.000Z"），但反序列化后是字符串而非 Date 实例；Map/Set 则直接丢失。
- 若需保留
Date类型，可在JSON.stringify()第二个参数中处理：JSON.stringify(obj, (k, v) => v instanceof Date ? v.toISOString() : v) - 读取时再用
new Date(str)恢复（注意判断字段是否为 ISO 字符串） - Map/Set 建议先转为普通对象或数组，例如：
Array.from(map.entries())
没有银弹 —— 序列化方案永远取决于你存的是什么、读的时候要什么类型。别假设 JSON.stringify + JSON.parse 能覆盖全部场景。
