====== 一文讲清楚:sessionStorage / localStorage / Cookie 的区别 ======
三者都能在浏览器里存东西,但**容量、活多久、谁能看见、会不会自动跟着请求走**完全不同。先给三句话结论:
* **Cookie**:容量最小(单条约 4 KB),**每次同域请求都被浏览器自动带上**,所以服务端能直接读到;主要用于承载**会话标识**。
* **localStorage**:容量约 5 MB,**同源永久保存**,不参与请求,必须自己用 JS 取出来塞进请求头或 body。
* **sessionStorage**:API 与容量和 localStorage 完全一样,唯一区别是**生命周期跟标签页绑定**,关掉标签页就没了。
后面所有细节都从两条判断依据推出来:
* **需要服务端「自动」看到吗?** 需要 → Cookie;不需要 → Web Storage(localStorage / sessionStorage)。
* **需要跨标签页共享吗?** 需要 → localStorage;每个标签页各存各的 → sessionStorage。
===== 一、一张表看全 =====
^ 维度 ^ 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:唯一会「自动携带」的那个 =====
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
由此带来三个不可替代的特点:
* **服务端能主动控制**:可以下发、可以改属性、可以要求过期,这是 localStorage 做不到的。
* **每次请求都白送一遍**:所以只能放很小的东西,绝不能塞业务数据(带宽会白白浪费)。
* **天然暴露于 CSRF**:因为不需要任何代码去「发送」,攻击者诱导你的浏览器发请求时它就跟着走了。
存储量级的口径:单条约 **4 KB**(含名称与属性)、每个域名约 **几十条**,各家浏览器略有差异。
三个安全属性要记牢,登录凭证必加:
^ 属性 ^ 作用 ^
| ''HttpOnly'' | JS 读不到(''document.cookie'' 不会返回它),挡 XSS 偷读 |
| ''Secure'' | 只在 HTTPS 上发送 |
| ''SameSite'' | 跨站请求是否携带:''Lax'' / ''Strict'' / ''None''(''None'' 必须配 ''Secure'') |
细节见 [[代码术语:cookie|Cookie]] 与 [[代码术语:一文讲清楚什么是csrf|CSRF]]。
===== 三、localStorage:同源共享的持久抽屉 =====
* 按**源**隔离:''https://app.example.com'' 与 ''https://other.example.com''、''http://app.example.com'' 是三个互不相干的仓库。
* **只要不清就一直存在**,同源的**所有标签页、窗口共享同一块数据**——改一处,其他地方下次读取就变了。
* **完全不参与网络请求**,服务端读不到,必须由前端代码手动取出来放进请求。
* 值**只能是字符串**,存对象要先 ''JSON.stringify''。
* API 是**同步**的,大批量读写会阻塞主线程。
* 它是「尽力而为」的存储:浏览器在存储压力下可能回收,**不能当成唯一数据源**。
===== 四、sessionStorage:标签页级的临时抽屉 =====
API 与 localStorage 一模一样,只有生命周期和作用域不同:
* **刷新页面不会丢**(同一个标签页还是同一个会话)。
* **关闭标签页或窗口即清空**;同一份数据在别的标签页里读不到。
* **新标签页里访问同一页面是空的**,从零开始。
* 但有两个容易踩的反直觉行为:
- **同一标签页内的同源 iframe 共享**同一份 sessionStorage(作用域是「源 + 顶层标签页」,不是「某个 document」)。
- **复制标签页、或用 ''window.open'' / ''target=_blank'' 打开同源页面时,会带上一份初始副本**,之后两边各自独立——所以它并非绝对的「物理隔离」。
适合放的东西:多步表单的中间状态、一次性的页面级筛选条件、路由跳转间的一次性提示(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; // 读之前先判空
===== 七、服务端为什么只能读写 Cookie =====
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);
});
* 同一个源的**其他**标签页会收到,**触发的那一个自己收不到**(这是防回环设计)。
* 因此它是跨标签页同步的经典手段(现代写法可用 ''BroadcastChannel'',能力更强也更清晰)。
* sessionStorage 不跨文档共享,这个事件对它基本没有意义。
==== 存储可能直接不可用 ====
* 某些隐私模式、被禁用存储的 iframe、企业策略环境下,**访问 localStorage 会直接抛 ''SecurityError''**,读写前最好包一层 try/catch 兜底。
* 第三方 iframe 中的 localStorage 现在会被浏览器**按顶层站点分区**,读写到的可能不是你以为的那一份。
===== 九、安全:同样是 XSS,两者的命运不一样 =====
^ 攻击 ^ Cookie ^ localStorage / sessionStorage ^
| XSS 偷读 | 加了 ''HttpOnly'' 就挡得住 | **挡不住**,一行脚本读走全部 |
| CSRF | 自动携带,天然暴露 | 不自动携带,天然免疫 |
所以结论是:
* **会话凭证最稳妥的放法是 ''HttpOnly + Secure + SameSite'' 的 Cookie**,代价是必须配 CSRF 防护(''SameSite'' + CSRF token)。
* **想免疫 CSRF,就把令牌放内存或请求头**(localStorage / sessionStorage / 纯内存变量),代价是 XSS 可读、刷新会丢(JWT 的两种方案详见 [[代码术语:authorization|Authorization]])。
* **XSS 才是最终 BOSS**:只要页面被注入脚本,任何前端可读的数据都不安全。浏览器存储**不是保险箱**,敏感信息(身份证、完整卡号、明文密码)不要往里放。
===== 十、怎么选:对照清单 =====
* 服务端要读、要自动携带 → **Cookie**(会话 ID、refresh token)
* 纯前端、跨标签、长期保存 → **localStorage**(主题、语言、上次访问页、草稿)
* 只在当前标签页存活 → **sessionStorage**(多步表单中间态、一次性 token、页面级筛选)
* 大量结构化数据、需要索引与事务 → **IndexedDB**(可到 GB 级,异步不阻塞)
* 离线静态资源缓存 → **Cache Storage**(Service Worker)
* 真正的会话数据 → **服务端 Session**,Cookie 里只放一个 ''sessionId''
* 跨标签页实时通信 → **BroadcastChannel**(比 ''storage'' 事件更好用)
===== 十一、它们不互斥:典型组合 =====
* **登录态**:''HttpOnly'' Cookie 放 ''sessionId'' 或 refresh token;access token 只放内存变量,刷新页面后静默续期。
* **界面偏好**:主题、语言、侧边栏折叠状态放 localStorage,首屏渲染时同步读取,避免闪烁。
* **一次性流程**:注册向导、下单多步表单放 sessionStorage,用户关掉标签页就自动丢弃,不留垃圾。
* **跳转提示**:''location.replace'' 前把一句提示写进 sessionStorage,落地页读完即删。
===== 十二、常见坑速查 =====
^ 现象 / 做法 ^ 原因与处理 ^
| 把 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|Cookie]] · [[代码术语:一文讲清楚什么是csrf|CSRF]] · [[代码术语:authorization|Authorization]] · [[jwt|JWT]]
===== 十四、结构总览 =====
```mdk height=580 color=#4f46e5
# 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
```
----
返回:[[代码术语]]