代码术语:sessionstorage_localstorage_cookie的区别

差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

代码术语: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 | 
 +| 生命周期 | 由 ''Expires'' / ''Max-Age'' 决定;不写=会话 Cookie,关浏览器消失 | 永久,除非主动清除 | 标签页(窗口)关闭即清 | 
 +| 作用域 | 域名 + 路径,按**站点**划分 | 按**源**(协议 + 域 + 端口) | 源 + 单个顶层标签页 | 
 +| 随请求自动发送 | **是** | 否 | 否 | 
 +| 服务端能否直接读写 | **能**(''Set-Cookie'' / ''Cookie'' 头) | 否 | 否 | 
 +| JS 能否读写 | 能(''HttpOnly'' 的除外) | 能 | 能 | 
 +| 跨标签页共享 | 同站共享 | **同源共享** | **不共享**,各一份 | 
 +| 前端 API | ''document.cookie'' 拼字符串 | ''getItem'' / ''setItem'' | 同 localStorage | 
 +| 容量超限 | 旧值被丢弃或覆盖 | 抛 ''QuotaExceededError'' | 同 localStorage | 
 + 
 +===== 二、Cookie:唯一会「自动携带」的那个 ===== 
 + 
 +Cookie 是三者中唯一有网络语义的:服务端用响应头 ''Set-Cookie'' 下发,浏览器此后对同域请求**自动**在请求头里带上 ''Cookie''。 
 + 
 +<code http> 
 +Set-Cookie: sid=abc123; Path=/; HttpOnly; Secure; SameSite=Lax; Max-Age=86400 
 + 
 +# 之后浏览器自动发,不需要写任何 JS 
 +GET /profile HTTP/1.1 
 +Host: example.com 
 +Cookie: sid=abc123 
 +</code> 
 + 
 +由此带来三个不可替代的特点: 
 + 
 +  * **服务端能主动控制**:可以下发、可以改属性、可以要求过期,这是 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)。 
 + 
 +===== 五、作用域与生命周期,图示更清楚 ===== 
 + 
 +<code> 
 +Cookie        按站点(example.com 及子域,受 Domain 控制) 
 +              每个请求都可能携带 → 见得到它的不只是 JS,还有服务端 
 + 
 +localStorage  按源:https://app.example.com ≠ http://app.example.com 
 + 
 +  tab1 ─┐ 
 +  tab2 ─┼─►  同一个源的仓库(三份视图指向同一块数据,互相可见) 
 +  tab3 ─┘ 
 + 
 +sessionStorage  按「源 + 顶层标签页」,每个标签页一份 
 + 
 +  tab1 ───►  仓库 A 
 +  tab2 ───►  仓库 B     (彼此不可见,关标签页即销毁) 
 +  tab3 ───►  仓库 C 
 +</code> 
 + 
 +===== 六、前端代码怎么写 ===== 
 + 
 +Cookie 没有对象式 API,''document.cookie'' 是一根拼好的字符串,只能自己拆: 
 + 
 +<code javascript> 
 +// 写(同名同路径会覆盖,注意别漏 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"; 
 +</code> 
 + 
 +Web Storage 是真正的键值 API,但**只能存字符串**: 
 + 
 +<code javascript> 
 +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;    // 读之前先判空 
 +</code> 
 + 
 +===== 七、服务端为什么只能读写 Cookie ===== 
 + 
 +localStorage / sessionStorage 存在浏览器内部,**永远不会出现在 HTTP 报文里**,服务端凭空拿不到。所以两种模式的落地方式完全不同: 
 + 
 +<code javascript> 
 +// 模式一:会话凭证放 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); 
 +}); 
 +</code> 
 + 
 +<code javascript> 
 +// 模式二:令牌放前端存储 —— 服务端看不到,得前端自己带上 
 +await fetch("/api/orders", { 
 +  method: "POST", 
 +  headers: { 
 +    "Content-Type": "application/json", 
 +    Authorization: `Bearer ${sessionStorage.getItem("token")}`, 
 +  }, 
 +  credentials: "include",   // 需要跨域携带 Cookie 时才加 
 +  body: JSON.stringify({ productId: 42 }), 
 +}); 
 +</code> 
 + 
 +一句话:**Cookie 是「服务端和浏览器共同维护」的,Web Storage 是「只属于前端」的。** 
 + 
 +===== 八、两个容易忽略的工程细节 ===== 
 + 
 +==== storage 事件:只在别的文档触发 ==== 
 + 
 +<code javascript> 
 +window.addEventListener("storage", (e) => { 
 +  // e.key / e.oldValue / e.newValue / e.storageArea / e.url 
 +  if (e.key === "theme") applyTheme(e.newValue); 
 +}); 
 +</code> 
 + 
 +  * 同一个源的**其他**标签页会收到,**触发的那一个自己收不到**(这是防回环设计)。 
 +  * 因此它是跨标签页同步的经典手段(现代写法可用 ''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 
 +``` 
 + 
 +---- 
 + 
 +返回:[[代码术语]] 

该主题尚不存在

您访问的页面并不存在。如果允许,您可以使用创建该页面按钮来创建它。

  • 代码术语/sessionstorage_localstorage_cookie的区别.1791943783.txt.gz
  • 最后更改: 2026/10/14 10:09
  • 由 张叶安