一文讲清楚: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) |
三、localStorage:同源共享的持久抽屉
- 只要不清就一直存在,同源的所有标签页、窗口共享同一块数据——改一处,其他地方下次读取就变了。
- 完全不参与网络请求,服务端读不到,必须由前端代码手动取出来放进请求。
- 值只能是字符串,存对象要先
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)。
- XSS 才是最终 BOSS:只要页面被注入脚本,任何前端可读的数据都不安全。浏览器存储不是保险箱,敏感信息(身份证、完整卡号、明文密码)不要往里放。
十、怎么选:对照清单
- 服务端要读、要自动携带 → Cookie(会话 ID、refresh token)
- 纯前端、跨标签、长期保存 → localStorage(主题、语言、上次访问页、草稿)
- 只在当前标签页存活 → sessionStorage(多步表单中间态、一次性 token、页面级筛选)
- 大量结构化数据、需要索引与事务 → IndexedDB(可到 GB 级,异步不阻塞)
- 离线静态资源缓存 → Cache Storage(Service Worker)
- 真正的会话数据 → 服务端 Session,Cookie 里只放一个
sessionId - 跨标签页实时通信 → BroadcastChannel(比
storage事件更好用)
十一、它们不互斥:典型组合
- 登录态:
HttpOnlyCookie 放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 · 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
返回:代码术语