前端本地存储实战：localStorage、sessionStorage 与 Cookie 深度对比

✅ Cookie：适合与服务器通信，管理会话或身份验证

• 适用场景：
  • 用户登录态管理（如 JSESSIONID、Auth-Token）；
  • 跟踪用户行为（如广告追踪、分析工具 GA）；
  • 保持用户的会话状态（如购物车信息，由服务端维护）；
  • 防止 CSRF 攻击（配合 SameSite 和 Secure 标志）；
• 最佳实践：
  • 使用 HttpOnly：防止 XSS 攻击窃取 Cookie；
  • 使用 Secure：确保 Cookie 只通过 HTTPS 传输；
  • 使用 SameSite=Strict 或 Lax：防止 CSRF 攻击；
  • 尽量减少 Cookie 大小（单个 Cookie ≤ 4KB）；
  • 避免在 Cookie 中存储敏感信息（如密码）；

📌 三、最佳实践总结

🛠️ 四、工具函数示例（封装）

为了方便调用，我们可以封装一套通用的存储工具类。这里需要注意的是，HttpOnly 标志无法通过客户端 JavaScript 设置，它必须由服务端在响应头中指定。因此下面的代码中移除了该属性，并添加了注释说明。

// 本地存储工具
const Storage = {
  // localStorage 读写
  setLocal(key, value) {
    localStorage.setItem(key, JSON.stringify(value));
  },
  getLocal(key, defaultValue = null) {
    const item = localStorage.getItem(key);
    return item ? JSON.parse(item) : defaultValue;
  },

  // sessionStorage 读写
  setSession(key, value) {
    sessionStorage.setItem(key, JSON.stringify(value));
  },
  getSession(key, defaultValue = null) {
    const item = sessionStorage.getItem(key);
    return item ? JSON.parse(item) : defaultValue;
  },

  // Cookie 读写（带安全标志）
  // 注意：HttpOnly 必须由服务端设置，客户端无法通过 document.cookie 设置
  setCookie(name, value, days = 7, path = '/') {
    const expires = new Date();
    expires.setTime(expires.getTime() + days * 24 * 60 * 60 * 1000);
    document.cookie = `${name}=${encodeURIComponent(value)};expires=${expires.toUTCString()};path=${path};Secure;SameSite=Lax`;
  },
  getCookie(name) {
    const value = `; ${document.cookie}`;
    const parts = value.split(`; ${name}=`);
    if (parts.length === 2) return decodeURIComponent(parts.pop().split(';').shift());
    return null;
  }
};

✅ 五、总结

localStorage：长期保存，跨页面共享，适合用户偏好、离线数据。sessionStorage：仅当前会话有效，适合临时状态、表单草稿。Cookie：随 HTTP 请求自动发送，适合身份验证、会话管理，必须配合安全标志使用。

六、附录：前端数据存储选型决策指南

面对多种存储方案时，可以参考以下逻辑进行选择：

1. 你需要存储什么类型的数据？
   • 如果是用户偏好、配置或非敏感业务数据 → 优先考虑 localStorage。
   • 如果是临时表单草稿、单次操作状态 → 选择 sessionStorage。
2. 数据需要长期保存吗？
   • 是 → localStorage。
   • 否（关闭浏览器即失效）→ sessionStorage。
3. 是否需要跨标签页共享？
   • 是 → localStorage。
   • 否 → sessionStorage。
4. 数据需要随 HTTP 请求发送给服务器吗？
   • 是 → Cookie（这是唯一能自动携带数据的选项）。
5. 是否涉及用户身份或敏感信息？
   • 是 → Cookie（务必配合 HttpOnly、Secure 及 SameSite 设置，且尽量在后端处理）。
   • 否 → 优先考虑 localStorage 或 sessionStorage 以减少网络开销。

在实际项目中，没有绝对完美的方案，只有最适合当下场景的选择。理解每种机制的底层原理，才能写出更安全、更高效的代码。