localStorage适合存前端专属数据(如用户偏好、UI状态),cookie适合存需服务端参与的小型关键数据(如HttpOnly登录态);选型依据是读取主体、时机及是否需发往服务器。
选哪个不看“功能多不多”,而要看“谁需要读、什么时候读、要不要发给服务器”。localStorage 是纯前端的键值对存储,浏览器关了还在,但服务端完全看不见;cookie 会随每次 HTTP 请求自动带上,服务端能读能写,但有大小限制(通常 4KB)、有同源策略和安全标记(HttpOnly、Secure)约束。
常见分工:
localStorage
cookie(配合 HttpOnly 防 XSS)localStorage 或 sessionStorage
cookie(设 Domain=.example.com)原生 document.cookie 是个怪异的字符串接口:读是拼接的键值对(a=1; b),写要手动拼
=2; c=3key=value; expires=...; path=/; secure,还容易漏分号或编码错误。直接手写极易出错,比如中文没 encodeURIComponent、过期时间格式错、路径没设导致读不到。
建议用轻量库或封装函数:
js-cookie(npm install js-cookie),一行读写:Cookie.set('token', 'abc123', { expires: 7, secure: true, sameSite: 'Strict' })setCookie 函数,必须处理 encodeURIComponent、默认 path=/、支持 maxAge(比 expires 更可靠)cookie 里存敏感信息(如密码、完整 token)——除非加了 HttpOnly 且前端只负责触发登录,不读 token 内容它看起来简单,但实际用起来有几个硬伤:
JSON.stringify(),取出来得 JSON.parse(),否则是 [object Object]
a.example.com 和 b.example.com)完全隔离,无法共享示例安全写法:
try {
localStorage.setItem('userPrefs', JSON.stringify({ theme: 'dark', lang: 'zh' }))
} catch (e) {
// 可能是隐私模式或超出配额,fallback 到内存对象
window._fallbackStorage = { theme: 'dark', lang: 'zh' }
}
常见反模式:
cookie 里 → 超出 4KB,请求头膨胀,拖慢所有请求localStorage 后又在每个 fetch 的 Authorization 头里手动读出来 → 安全风险高(XSS 可盗),不如用 HttpOnly cookie + 后端验证localStorage 存登录态并自己实现“过期”逻辑 → 容易因时钟误差或未清理导致状态不一致localStorage 做状态同步 → 应优先用 React/Vue 状态管理,存储只做持久化兜底真正该纠结的不是“怎么选”,而是“这个数据到底需不需要离开当前页面上下文”。如果答案是否定的,连 localStorage 都不用碰。