三者都能在浏览器里存东西,但容量、活多久、谁能看见、会不会自动跟着请求走完全不同。先给三句话结论:
后面所有细节都从两条判断依据推出来:
| 维度 | 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) |
JSON.stringify。API 与 localStorage 一模一样,只有生命周期和作用域不同:
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; // 读之前先判空
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 是「只属于前端」的。
window.addEventListener("storage", (e) => { // e.key / e.oldValue / e.newValue / e.storageArea / e.url if (e.key === "theme") applyTheme(e.newValue); });
BroadcastChannel,能力更强也更清晰)。SecurityError,读写前最好包一层 try/catch 兜底。| 攻击 | Cookie | localStorage / sessionStorage |
|---|---|---|
| XSS 偷读 | 加了 HttpOnly 就挡得住 | 挡不住,一行脚本读走全部 |
| CSRF | 自动携带,天然暴露 | 不自动携带,天然免疫 |
所以结论是:
HttpOnly + Secure + SameSite 的 Cookie,代价是必须配 CSRF 防护(SameSite + CSRF token)。sessionIdstorage 事件更好用)HttpOnly Cookie 放 sessionId 或 refresh token;access token 只放内存变量,刷新页面后静默续期。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
返回:代码术语