目录

一文讲清楚:sessionStorage / localStorage / Cookie 的区别

三者都能在浏览器里存东西,但容量、活多久、谁能看见、会不会自动跟着请求走完全不同。先给三句话结论:

后面所有细节都从两条判断依据推出来:

一、一张表看全

维度 Cookie localStorage sessionStorage
规范 RFC 6265 HTML Web Storage HTML Web Storage
容量 单条约 4 KB,每域名几十条 约 5 MB(各浏览器 5~10 MB) 同 localStorage
生命周期 由 Expires / Max-Age 决定;不写=会话 Cookie,关浏览器消失 永久,除非主动清除 标签页(窗口)关闭即清
作用域 域名 + 路径,按站点划分 按源(协议 + 域 + 端口) 源 + 单个顶层标签页
随请求自动发送 是 否 否
服务端能否直接读写 能(Set-Cookie / Cookie 头) 否 否
JS 能否读写 能(HttpOnly 的除外) 能 能
跨标签页共享 同站共享 同源共享 不共享,各一份
前端 API document.cookie 拼字符串 getItem / setItem 同 localStorage
容量超限 旧值被丢弃或覆盖 抛 QuotaExceededError 同 localStorage

Cookie 是三者中唯一有网络语义的:服务端用响应头 Set-Cookie 下发,浏览器此后对同域请求自动在请求头里带上 Cookie。

Set-Cookie: sid=abc123; Path=/; HttpOnly; Secure; SameSite=Lax; Max-Age=86400
 
# 之后浏览器自动发,不需要写任何 JS
GET /profile HTTP/1.1
Host: example.com
Cookie: sid=abc123

由此带来三个不可替代的特点:

存储量级的口径:单条约 4 KB(含名称与属性)、每个域名约 几十条,各家浏览器略有差异。

三个安全属性要记牢,登录凭证必加:

属性 作用
HttpOnly JS 读不到(document.cookie 不会返回它),挡 XSS 偷读
Secure 只在 HTTPS 上发送
SameSite 跨站请求是否携带:Lax / Strict / None(None 必须配 Secure)

细节见 Cookie 与 CSRF。

三、localStorage:同源共享的持久抽屉

四、sessionStorage:标签页级的临时抽屉

API 与 localStorage 一模一样,只有生命周期和作用域不同:

适合放的东西:多步表单的中间状态、一次性的页面级筛选条件、路由跳转间的一次性提示(flash)。

五、作用域与生命周期,图示更清楚

Cookie        按站点(example.com 及子域,受 Domain 控制)
              每个请求都可能携带 → 见得到它的不只是 JS,还有服务端

localStorage  按源:https://app.example.com ≠ http://app.example.com

  tab1 ─┐
  tab2 ─┼─►  同一个源的仓库(三份视图指向同一块数据,互相可见)
  tab3 ─┘

sessionStorage  按「源 + 顶层标签页」,每个标签页一份

  tab1 ───►  仓库 A
  tab2 ───►  仓库 B     (彼此不可见,关标签页即销毁)
  tab3 ───►  仓库 C

六、前端代码怎么写

Cookie 没有对象式 API,document.cookie 是一根拼好的字符串,只能自己拆:

// 写(同名同路径会覆盖,注意别漏 Path)
document.cookie = "theme=dark; Path=/; Max-Age=2592000; Secure; SameSite=Lax";
 
// 读:只拿得到非 HttpOnly 的那些
const theme = document.cookie
  .split("; ")
  .find((row) => row.startsWith("theme="))
  ?.split("=")[1] ?? null;
 
// 删:把 Max-Age 设为 0,且 Path / Domain 必须与写入时一致
document.cookie = "theme=; Path=/; Max-Age=0";

Web Storage 是真正的键值 API,但只能存字符串:

localStorage.setItem("theme", "dark");          // 纯字符串
localStorage.getItem("theme");                  // "dark"
localStorage.removeItem("theme");
localStorage.clear();                           // 清空本源的全部
 
// 存对象必须先序列化,否则会变成 "[object Object]"
const user = { id: 7, name: "alice" };
sessionStorage.setItem("user", JSON.stringify(user));
 
const raw = sessionStorage.getItem("user");
const parsed = raw ? JSON.parse(raw) : null;    // 读之前先判空

localStorage / sessionStorage 存在浏览器内部,永远不会出现在 HTTP 报文里,服务端凭空拿不到。所以两种模式的落地方式完全不同:

// 模式一:会话凭证放 Cookie —— 服务端能直接控制
res.cookie("sid", sid, {
  httpOnly: true,       // JS 拿不到,XSS 也偷不走
  secure: true,         // 只走 HTTPS
  sameSite: "lax",      // 跨站请求默认不带
  path: "/",
  maxAge: 7 * 24 * 3600 * 1000,
});
 
// 真正的数据在服务端,Cookie 里只是一张号码牌
app.get("/me", (req, res) => {
  const user = sessionStore.get(req.cookies.sid);
  if (!user) return res.status(401).end();
  res.json(user);
});
// 模式二:令牌放前端存储 —— 服务端看不到,得前端自己带上
await fetch("/api/orders", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${sessionStorage.getItem("token")}`,
  },
  credentials: "include",   // 需要跨域携带 Cookie 时才加
  body: JSON.stringify({ productId: 42 }),
});

一句话:Cookie 是「服务端和浏览器共同维护」的,Web Storage 是「只属于前端」的。

八、两个容易忽略的工程细节

storage 事件:只在别的文档触发

window.addEventListener("storage", (e) => {
  // e.key / e.oldValue / e.newValue / e.storageArea / e.url
  if (e.key === "theme") applyTheme(e.newValue);
});

存储可能直接不可用

九、安全:同样是 XSS,两者的命运不一样

攻击 Cookie localStorage / sessionStorage
XSS 偷读 加了 HttpOnly 就挡得住 挡不住,一行脚本读走全部
CSRF 自动携带,天然暴露 不自动携带,天然免疫

所以结论是:

十、怎么选:对照清单

十一、它们不互斥:典型组合

十二、常见坑速查

现象 / 做法 原因与处理
把 JWT 放 localStorage XSS 一读即走,且无法 HttpOnly;高风险场景应放 Cookie 或内存
把敏感数据存进 localStorage 同源脚本全都能读,且是明文
存对象忘了序列化 取出来是 “[object Object]”,要先 JSON.stringify
JSON.parse(null) 直接用 getItem 可能返回 null,读之前先判空
用 localStorage 存大数组 同步 API 会阻塞主线程,5 MB 也可能超限
忽略 QuotaExceededError 配额满或隐私模式下会抛错,要 try/catch
用 Cookie 存复杂对象 4 KB 上限 + 每次请求都发送,纯浪费带宽
删除 Cookie 时漏了 Path / Domain 属性不一致=删的是另一个 Cookie
以为清 Cookie 就清干净了 Cookie 与 Web Storage 互相独立,只有「清除网站数据」才一起清
以为 localStorage 永远不会被清 它是 best-effort 存储,磁盘压力下浏览器可能回收
用 js-cookie 之外手写 document.cookie 却不转义 值里的 ; 和 = 需要 encodeURIComponent
想跨子域共享 localStorage 域不同就是不同源,不共享;跨子域只能靠 Cookie 或服务端转发
SSR 里直接访问 localStorage 服务端没有 window,会报错;只能在浏览器端读取
用 sessionStorage 做跨标签通信 它不跨标签,改用 localStorage + storage 事件或 BroadcastChannel
以为复制标签页是干净的 复制/window.open 同源页会带上 sessionStorage 的初始副本

十三、一句话总结

**Cookie 是跟着请求走的小纸条(4 KB,服务端看得见);localStorage 是同源共享的持久抽屉(约 5 MB,跨标签);sessionStorage 是每个标签页一个的临时抽屉(关掉就没了)。前者的代价是 CSRF,后两者的代价是 XSS——所以没有哪个能当保险箱,敏感数据始终留在服务端。**

相关:Cookie · CSRF · Authorization · JWT

十四、结构总览

# sessionStorage / localStorage / Cookie
## 一句话区别
### Cookie
- 每次同域请求自动携带
- 单条约 4 KB,服务端可读
- 用来放会话标识
### localStorage
- 约 5 MB
- 同源共享、永久保存
- 不参与请求
### sessionStorage
- 容量与 API 同 localStorage
- 每个标签页一份
- 关标签页即清空
## 核心对比
### 容量
- Cookie 约 4 KB 且每域几十条
- Web Storage 约 5 MB
### 生命周期
- Cookie 看 Max-Age,不写即会话级
- localStorage 永久
- sessionStorage 跟标签页走
### 作用域
- Cookie 域名 + 路径
- localStorage 源,跨标签共享
- sessionStorage 源 + 单个标签页
### 自动携带
- Cookie 是
- Web Storage 否
### 服务端可见
- 只有 Cookie 能直接读写
## 反直觉行为
- 同标签页内同源 iframe 共享 sessionStorage
- 复制标签页会带上副本
- storage 事件不触发在自己身上
- 第三方 iframe 的存储会被分区
- 隐私模式可能直接抛 SecurityError
## 安全
### XSS
- HttpOnly 挡得住 Cookie
- 挡不住 Web Storage
### CSRF
- Cookie 自动携带天然暴露
- Web Storage 天然免疫
### 结论
- 会话凭证放 HttpOnly Cookie
- 或放内存 + 请求头
- XSS 才是最终 BOSS
- 浏览器存储不是保险箱
## 怎么选
- 服务端要用 → Cookie
- 前端跨标签持久 → localStorage
- 只在当前标签页 → sessionStorage
- 大数据与索引 → IndexedDB
- 离线资源 → Cache Storage
- 会话数据 → 服务端 Session
- 跨标签通信 → BroadcastChannel
## 常见坑
- JWT 放 localStorage 被 XSS 偷
- 忘了 JSON 序列化
- 同步 API 阻塞主线程
- 忽略 QuotaExceededError
- 删 Cookie 漏 Path / Domain
- 以为 localStorage 永不被清
- SSR 里直接访问 localStorage

返回:代码术语