javascript的localStorage和sessionStorage如何存储数据？【教程】

夜晨 2026-01-17 00:00:00 次阅读

localStorage和sessionStorage只能存储字符串，存对象需JSON.stringify()、读取需JSON.parse()并加try/catch防错，二者API相同但生命周期不同：localStorage持久化，sessionStorage仅限当前标签页。

它们只能存字符串，任何非字符串数据都得自己转成字符串再存，否则会意外变成 "[object Object]" 或 "undefined"。

localStorage 和 sessionStorage 的 setItem 方法只接受字符串值

这两个 API 的底层设计就是键值对存储，且 value 参数类型被强制限定为 DOMString（即字符串）。传入对象、数组、数字甚至布尔值，都会被隐式调用 .toString()：

localStorage.setItem('user', { name: 'Alice' });
console.log(localStorage.getItem('user')); // "[object Object]"

localStorage.setItem('count', 42);
console.log(localStorage.getItem('count')); // "42"（看似正常，但类型已丢失）

所以实际使用中必须显式序列化：

存对象/数组：统一用 JSON.stringify()
读取后：必须用 JSON.parse() 恢复，且要加 try/catch 防止解析失败（比如值被手动篡改过）
存布尔或数字：虽然能隐式转字符串，但读取时仍是字符串，需手动转换（Boolean()、Number() 或一元加号 +）

如何安全地存取 JSON 数据

最常踩的坑是没处理 JSON.parse() 报错。用户可能直接在开发者工具里把 localStorage 值改成非法 JSON，导致页面 JS 崩溃。

function safeSet(key, value) {
  try {
    localStorage.setItem(key, JSON.stringify(value));
  } catch (e) {
    console.error('localStorage set failed:', e);
  }
}

function safeGet(key, defaultValue = null) {
  const raw = localStorage.getItem(key);
  if (!raw) return defaultValue;
  try {
    return JSON.parse(raw);
  } catch (e) {
    console.warn('Invalid JSON in localStorage:', key, e);
    return defaultValue;
  }
}

safeSet('profile', { id: 123, active: true });
console.log(safeGet('profile')); // { id: 123, active: true }