差别
这里会显示出您选择的修订版和当前版本之间的差别。
| 代码术语:sessionstorage_localstorage_cookie的区别 [2026/10/14 10:09] – 创建 张叶安 | 代码术语:sessionstorage_localstorage_cookie的区别 [2026/10/14 10:11] (当前版本) – 新建:一文讲清楚 sessionStorage / localStorage / Cookie 的区别 张叶安 | ||
|---|---|---|---|
| 行 1: | 行 1: | ||
| - | 1 | + | ====== 一文讲清楚: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 | | ||
| + | | 生命周期 | 由 '' | ||
| + | | 作用域 | 域名 + 路径,按**站点**划分 | 按**源**(协议 + 域 + 端口) | 源 + 单个顶层标签页 | | ||
| + | | 随请求自动发送 | **是** | 否 | 否 | | ||
| + | | 服务端能否直接读写 | **能**('' | ||
| + | | JS 能否读写 | 能('' | ||
| + | | 跨标签页共享 | 同站共享 | **同源共享** | **不共享**,各一份 | | ||
| + | | 前端 API | '' | ||
| + | | 容量超限 | 旧值被丢弃或覆盖 | 抛 '' | ||
| + | |||
| + | ===== 二、Cookie:唯一会「自动携带」的那个 ===== | ||
| + | |||
| + | Cookie 是三者中唯一有网络语义的:服务端用响应头 '' | ||
| + | |||
| + | <code http> | ||
| + | Set-Cookie: sid=abc123; Path=/; HttpOnly; Secure; SameSite=Lax; | ||
| + | |||
| + | # 之后浏览器自动发,不需要写任何 JS | ||
| + | GET /profile HTTP/1.1 | ||
| + | Host: example.com | ||
| + | Cookie: sid=abc123 | ||
| + | </ | ||
| + | |||
| + | 由此带来三个不可替代的特点: | ||
| + | |||
| + | * **服务端能主动控制**:可以下发、可以改属性、可以要求过期,这是 localStorage 做不到的。 | ||
| + | * **每次请求都白送一遍**:所以只能放很小的东西,绝不能塞业务数据(带宽会白白浪费)。 | ||
| + | * **天然暴露于 CSRF**:因为不需要任何代码去「发送」,攻击者诱导你的浏览器发请求时它就跟着走了。 | ||
| + | |||
| + | 存储量级的口径:单条约 **4 KB**(含名称与属性)、每个域名约 **几十条**,各家浏览器略有差异。 | ||
| + | |||
| + | 三个安全属性要记牢,登录凭证必加: | ||
| + | |||
| + | ^ 属性 ^ 作用 ^ | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | |||
| + | 细节见 [[代码术语: | ||
| + | |||
| + | ===== 三、localStorage:同源共享的持久抽屉 ===== | ||
| + | |||
| + | * 按**源**隔离:'' | ||
| + | * **只要不清就一直存在**,同源的**所有标签页、窗口共享同一块数据**——改一处,其他地方下次读取就变了。 | ||
| + | * **完全不参与网络请求**,服务端读不到,必须由前端代码手动取出来放进请求。 | ||
| + | * 值**只能是字符串**,存对象要先 '' | ||
| + | * API 是**同步**的,大批量读写会阻塞主线程。 | ||
| + | * 它是「尽力而为」的存储:浏览器在存储压力下可能回收,**不能当成唯一数据源**。 | ||
| + | |||
| + | ===== 四、sessionStorage:标签页级的临时抽屉 ===== | ||
| + | |||
| + | API 与 localStorage 一模一样,只有生命周期和作用域不同: | ||
| + | |||
| + | * **刷新页面不会丢**(同一个标签页还是同一个会话)。 | ||
| + | * **关闭标签页或窗口即清空**;同一份数据在别的标签页里读不到。 | ||
| + | * **新标签页里访问同一页面是空的**,从零开始。 | ||
| + | * 但有两个容易踩的反直觉行为: | ||
| + | |||
| + | - **同一标签页内的同源 iframe 共享**同一份 sessionStorage(作用域是「源 + 顶层标签页」,不是「某个 document」)。 | ||
| + | - **复制标签页、或用 '' | ||
| + | |||
| + | 适合放的东西:多步表单的中间状态、一次性的页面级筛选条件、路由跳转间的一次性提示(flash)。 | ||
| + | |||
| + | ===== 五、作用域与生命周期,图示更清楚 ===== | ||
| + | |||
| + | < | ||
| + | Cookie | ||
| + | 每个请求都可能携带 → 见得到它的不只是 JS,还有服务端 | ||
| + | |||
| + | localStorage | ||
| + | |||
| + | tab1 ─┐ | ||
| + | tab2 ─┼─► | ||
| + | tab3 ─┘ | ||
| + | |||
| + | sessionStorage | ||
| + | |||
| + | tab1 ───► | ||
| + | tab2 ───► | ||
| + | tab3 ───► | ||
| + | </ | ||
| + | |||
| + | ===== 六、前端代码怎么写 ===== | ||
| + | |||
| + | Cookie 没有对象式 API,'' | ||
| + | |||
| + | <code javascript> | ||
| + | // 写(同名同路径会覆盖,注意别漏 Path) | ||
| + | document.cookie = " | ||
| + | |||
| + | // 读:只拿得到非 HttpOnly 的那些 | ||
| + | const theme = document.cookie | ||
| + | .split("; | ||
| + | .find((row) => row.startsWith(" | ||
| + | ? | ||
| + | |||
| + | // 删:把 Max-Age 设为 0,且 Path / Domain 必须与写入时一致 | ||
| + | document.cookie = " | ||
| + | </ | ||
| + | |||
| + | Web Storage 是真正的键值 API,但**只能存字符串**: | ||
| + | |||
| + | <code javascript> | ||
| + | localStorage.setItem(" | ||
| + | localStorage.getItem(" | ||
| + | localStorage.removeItem(" | ||
| + | localStorage.clear(); | ||
| + | |||
| + | // 存对象必须先序列化,否则会变成 " | ||
| + | const user = { id: 7, name: " | ||
| + | sessionStorage.setItem(" | ||
| + | |||
| + | const raw = sessionStorage.getItem(" | ||
| + | const parsed = raw ? JSON.parse(raw) : null; // 读之前先判空 | ||
| + | </ | ||
| + | |||
| + | ===== 七、服务端为什么只能读写 Cookie ===== | ||
| + | |||
| + | localStorage / sessionStorage 存在浏览器内部,**永远不会出现在 HTTP 报文里**,服务端凭空拿不到。所以两种模式的落地方式完全不同: | ||
| + | |||
| + | <code javascript> | ||
| + | // 模式一:会话凭证放 Cookie —— 服务端能直接控制 | ||
| + | res.cookie(" | ||
| + | httpOnly: true, // JS 拿不到,XSS 也偷不走 | ||
| + | secure: true, // 只走 HTTPS | ||
| + | sameSite: " | ||
| + | path: "/", | ||
| + | maxAge: 7 * 24 * 3600 * 1000, | ||
| + | }); | ||
| + | |||
| + | // 真正的数据在服务端,Cookie 里只是一张号码牌 | ||
| + | app.get("/ | ||
| + | const user = sessionStore.get(req.cookies.sid); | ||
| + | if (!user) return res.status(401).end(); | ||
| + | res.json(user); | ||
| + | }); | ||
| + | </ | ||
| + | |||
| + | <code javascript> | ||
| + | // 模式二:令牌放前端存储 —— 服务端看不到,得前端自己带上 | ||
| + | await fetch("/ | ||
| + | method: " | ||
| + | headers: { | ||
| + | " | ||
| + | Authorization: | ||
| + | }, | ||
| + | credentials: | ||
| + | body: JSON.stringify({ productId: 42 }), | ||
| + | }); | ||
| + | </ | ||
| + | |||
| + | 一句话:**Cookie 是「服务端和浏览器共同维护」的,Web Storage 是「只属于前端」的。** | ||
| + | |||
| + | ===== 八、两个容易忽略的工程细节 ===== | ||
| + | |||
| + | ==== storage 事件:只在别的文档触发 ==== | ||
| + | |||
| + | <code javascript> | ||
| + | window.addEventListener(" | ||
| + | // e.key / e.oldValue / e.newValue / e.storageArea / e.url | ||
| + | if (e.key === " | ||
| + | }); | ||
| + | </ | ||
| + | |||
| + | * 同一个源的**其他**标签页会收到,**触发的那一个自己收不到**(这是防回环设计)。 | ||
| + | * 因此它是跨标签页同步的经典手段(现代写法可用 '' | ||
| + | * sessionStorage 不跨文档共享,这个事件对它基本没有意义。 | ||
| + | |||
| + | ==== 存储可能直接不可用 ==== | ||
| + | |||
| + | * 某些隐私模式、被禁用存储的 iframe、企业策略环境下,**访问 localStorage 会直接抛 '' | ||
| + | * 第三方 iframe 中的 localStorage 现在会被浏览器**按顶层站点分区**,读写到的可能不是你以为的那一份。 | ||
| + | |||
| + | ===== 九、安全:同样是 XSS,两者的命运不一样 ===== | ||
| + | |||
| + | ^ 攻击 ^ Cookie ^ localStorage / sessionStorage ^ | ||
| + | | XSS 偷读 | 加了 '' | ||
| + | | CSRF | 自动携带,天然暴露 | 不自动携带,天然免疫 | | ||
| + | |||
| + | 所以结论是: | ||
| + | |||
| + | * **会话凭证最稳妥的放法是 '' | ||
| + | * **想免疫 CSRF,就把令牌放内存或请求头**(localStorage / sessionStorage / 纯内存变量),代价是 XSS 可读、刷新会丢(JWT 的两种方案详见 [[代码术语: | ||
| + | * **XSS 才是最终 BOSS**:只要页面被注入脚本,任何前端可读的数据都不安全。浏览器存储**不是保险箱**,敏感信息(身份证、完整卡号、明文密码)不要往里放。 | ||
| + | |||
| + | ===== 十、怎么选:对照清单 ===== | ||
| + | |||
| + | * 服务端要读、要自动携带 → **Cookie**(会话 ID、refresh token) | ||
| + | * 纯前端、跨标签、长期保存 → **localStorage**(主题、语言、上次访问页、草稿) | ||
| + | * 只在当前标签页存活 → **sessionStorage**(多步表单中间态、一次性 token、页面级筛选) | ||
| + | * 大量结构化数据、需要索引与事务 → **IndexedDB**(可到 GB 级,异步不阻塞) | ||
| + | * 离线静态资源缓存 → **Cache Storage**(Service Worker) | ||
| + | * 真正的会话数据 → **服务端 Session**,Cookie 里只放一个 '' | ||
| + | * 跨标签页实时通信 → **BroadcastChannel**(比 '' | ||
| + | |||
| + | ===== 十一、它们不互斥:典型组合 ===== | ||
| + | |||
| + | * **登录态**:'' | ||
| + | * **界面偏好**:主题、语言、侧边栏折叠状态放 localStorage,首屏渲染时同步读取,避免闪烁。 | ||
| + | * **一次性流程**:注册向导、下单多步表单放 sessionStorage,用户关掉标签页就自动丢弃,不留垃圾。 | ||
| + | * **跳转提示**:'' | ||
| + | |||
| + | ===== 十二、常见坑速查 ===== | ||
| + | |||
| + | ^ 现象 / 做法 ^ 原因与处理 ^ | ||
| + | | 把 JWT 放 localStorage | XSS 一读即走,且无法 '' | ||
| + | | 把敏感数据存进 localStorage | 同源脚本全都能读,且是明文 | | ||
| + | | 存对象忘了序列化 | 取出来是 ''" | ||
| + | | '' | ||
| + | | 用 localStorage 存大数组 | 同步 API 会阻塞主线程,5 MB 也可能超限 | | ||
| + | | 忽略 '' | ||
| + | | 用 Cookie 存复杂对象 | 4 KB 上限 + 每次请求都发送,纯浪费带宽 | | ||
| + | | 删除 Cookie 时漏了 Path / Domain | 属性不一致=删的是另一个 Cookie | | ||
| + | | 以为清 Cookie 就清干净了 | Cookie 与 Web Storage 互相独立,只有「清除网站数据」才一起清 | | ||
| + | | 以为 localStorage 永远不会被清 | 它是 best-effort 存储,磁盘压力下浏览器可能回收 | | ||
| + | | 用 '' | ||
| + | | 想跨子域共享 localStorage | 域不同就是不同源,不共享;跨子域只能靠 Cookie 或服务端转发 | | ||
| + | | SSR 里直接访问 localStorage | 服务端没有 '' | ||
| + | | 用 sessionStorage 做跨标签通信 | 它不跨标签,改用 localStorage + '' | ||
| + | | 以为复制标签页是干净的 | 复制/'' | ||
| + | |||
| + | ===== 十三、一句话总结 ===== | ||
| + | |||
| + | > **Cookie 是跟着请求走的小纸条(4 KB,服务端看得见);localStorage 是同源共享的持久抽屉(约 5 MB,跨标签);sessionStorage 是每个标签页一个的临时抽屉(关掉就没了)。前者的代价是 CSRF,后两者的代价是 XSS——所以没有哪个能当保险箱,敏感数据始终留在服务端。** | ||
| + | |||
| + | 相关:[[代码术语: | ||
| + | |||
| + | ===== 十四、结构总览 ===== | ||
| + | |||
| + | ```mdk height=580 color=# | ||
| + | # 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 | ||
| + | ``` | ||
| + | |||
| + | ---- | ||
| + | |||
| + | 返回:[[代码术语]] | ||