代码术语:sessionstorage_localstorage_cookie的区别

一文讲清楚: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 是三者中唯一有网络语义的:服务端用响应头 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 与 CSRF。

  • 按源隔离:https://app.example.com 与 https://other.example.com、http://app.example.com 是三个互不相干的仓库。
  • 只要不清就一直存在,同源的所有标签页、窗口共享同一块数据——改一处,其他地方下次读取就变了。
  • 完全不参与网络请求,服务端读不到,必须由前端代码手动取出来放进请求。
  • 值只能是字符串,存对象要先 JSON.stringify。
  • API 是同步的,大批量读写会阻塞主线程。
  • 它是「尽力而为」的存储:浏览器在存储压力下可能回收,不能当成唯一数据源。

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;    // 读之前先判空

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,能力更强也更清晰)。
  • sessionStorage 不跨文档共享,这个事件对它基本没有意义。
  • 某些隐私模式、被禁用存储的 iframe、企业策略环境下,访问 localStorage 会直接抛 SecurityError,读写前最好包一层 try/catch 兜底。
  • 第三方 iframe 中的 localStorage 现在会被浏览器按顶层站点分区,读写到的可能不是你以为的那一份。
攻击 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 事件更好用)
  • 登录态: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 · 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

返回:代码术语

该主题尚不存在

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

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