跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像AI 生图工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
JavaScript大前端

前端缓存策略最佳实践:LocalStorage 与 Service Worker

探讨了前端缓存策略的重要性及实现方法。通过对比滥用 localStorage 的错误案例与构建完整缓存管理系统的正确实践,阐述了性能提升、用户体验优化及带宽节省的价值。内容涵盖 localStorage、sessionStorage、IndexedDB 及 Service Worker 的适用场景,强调设置过期时间、统一命名规范及错误处理机制。最终目标是建立合理的缓存策略以提升网站加载速度和可靠性。

暗影行者发布于 2026/4/6更新于 2026/7/2144 浏览

前端缓存策略最佳实践:LocalStorage 与 Service Worker

常见误区

前端缓存?这不是浏览器的事吗?

"我不需要管缓存,浏览器会自动处理"——结果网站加载慢,用户体验差, "缓存就是 localStorage 嘛,多简单"——结果缓存管理混乱,内存占用高, "我直接禁用缓存,省得麻烦"——结果每次都重新加载,浪费带宽。

实际上,前端缓存不是简单的 localStorage,而是一套完整的策略!

为什么你需要这个?

  • 性能提升:减少重复请求,加快页面加载速度
  • 用户体验:离线访问,减少等待时间
  • 带宽节省:减少服务器流量,降低成本
  • 可靠性:网络不稳定时仍能正常访问

反面教材

// 反面教材:滥用 localStorage
function fetchData() {
  // 每次都从 API 获取数据
  return fetch('https://api.example.com/data')
    .then(res => res.json())
    .then(data => {
      // 直接存储到 localStorage
      localStorage.setItem('data', JSON.stringify(data));
      return data;
    });
}

// 反面教材:没有缓存失效策略
function getCachedData() {
  // 永远使用缓存,不考虑过期
  const cachedData = localStorage.getItem('data');
  return cachedData ? JSON.parse(cachedData) : null;
}

// 反面教材:缓存键命名混乱
function () {
  
  .(, .(data));
}
cacheData
key, data
// 缓存键没有统一规范
localStorage
setItem
`cache_${key}_${Date.now()}`
JSON
stringify

正确的做法

// 正确的做法:完整的缓存策略
class CacheManager {
  constructor() {
    this.cachePrefix = 'app_cache_';
    this.defaultExpiry = 24 * 60 * 60 * 1000; // 24 小时
  }

  // 生成缓存键
  generateKey(key) {
    return `${this.cachePrefix}${key}`;
  }

  // 存储数据到缓存
  set(key, data, expiry = this.defaultExpiry) {
    const cacheItem = { data, expiry: Date.now() + expiry, timestamp: Date.now() };
    try {
      localStorage.setItem(this.generateKey(key), JSON.stringify(cacheItem));
    } catch (error) {
      console.error('Cache storage error:', error);
      // 处理存储空间不足的情况
      this.clearOldCache();
    }
  }

  // 从缓存获取数据
  get(key) {
    const cacheItem = localStorage.getItem(this.generateKey(key));
    if (!cacheItem) {
      return null;
    }
    try {
      const parsedItem = JSON.parse(cacheItem);
      // 检查是否过期
      if (Date.now() > parsedItem.expiry) {
        this.remove(key);
        return null;
      }
      return parsedItem.data;
    } catch (error) {
      console.error('Cache parsing error:', error);
      this.remove(key);
      return null;
    }
  }

  // 移除缓存
  remove(key) {
    localStorage.removeItem(this.generateKey(key));
  }

  // 清空所有缓存
  clear() {
    Object.keys(localStorage).forEach(key => {
      if (key.startsWith(this.cachePrefix)) {
        localStorage.removeItem(key);
      }
    });
  }

  // 清理过期缓存
  clearOldCache() {
    Object.keys(localStorage).forEach(key => {
      if (key.startsWith(this.cachePrefix)) {
        try {
          const item = JSON.parse(localStorage.getItem(key));
          if (Date.now() > item.expiry) {
            localStorage.removeItem(key);
          }
        } catch (error) {
          localStorage.removeItem(key);
        }
      }
    });
  }

  // 获取缓存大小
  getCacheSize() {
    let size = 0;
    Object.keys(localStorage).forEach(key => {
      if (key.startsWith(this.cachePrefix)) {
        size += localStorage.getItem(key).length;
      }
    });
    return size;
  }
}

// 正确的做法:使用 Service Worker 缓存
// service-worker.js
const CACHE_NAME = 'app-cache-v1';
const ASSETS_TO_CACHE = [
  '/',
  '/index.html',
  '/manifest.json',
  '/static/js/main.js',
  '/static/css/main.css',
  '/static/images/logo.png'
];

// 安装 Service Worker
self.addEventListener('install', event => {
  event.waitUntil(
    caches.open(CACHE_NAME)
      .then(cache => {
        console.log('Opened cache');
        return cache.addAll(ASSETS_TO_CACHE);
      })
  );
});

// 激活 Service Worker
self.addEventListener('activate', event => {
  const cacheWhitelist = [CACHE_NAME];
  event.waitUntil(
    caches.keys().then(cacheNames => {
      return Promise.all(
        cacheNames.map(cacheName => {
          if (cacheWhitelist.indexOf(cacheName) === -1) {
            return caches.delete(cacheName);
          }
        })
      );
    })
  );
});

// 拦截网络请求
self.addEventListener('fetch', event => {
  event.respondWith(
    caches.match(event.request)
      .then(response => {
        // 如果缓存中有响应,直接返回
        if (response) {
          return response;
        }
        // 否则发起网络请求
        return fetch(event.request)
          .then(response => {
            // 如果响应有效,缓存一份
            if (response && response.status === 200 && response.type === 'basic') {
              const responseToCache = response.clone();
              caches.open(CACHE_NAME)
                .then(cache => {
                  cache.put(event.request, responseToCache);
                });
            }
            return response;
          })
      )
  );
});

// 正确的做法:API 请求缓存
async function fetchWithCache(url, options = {}) {
  const cacheKey = `api_${url}_${JSON.stringify(options)}`;
  const cacheManager = new CacheManager();
  // 尝试从缓存获取
  const cachedData = cacheManager.get(cacheKey);
  if (cachedData) {
    return cachedData;
  }
  // 发起网络请求
  const response = await fetch(url, options);
  const data = await response.json();
  // 缓存数据
  cacheManager.set(cacheKey, data, 5 * 60 * 1000); // 5 分钟过期
  return data;
}

核心建议

看看,这才叫前端缓存策略!不是简单地使用 localStorage,而是构建一套完整的缓存管理系统,包括过期策略、空间管理、Service Worker 等。

注意,缓存不是越多越好,而是要合理使用。你需要根据数据的性质和使用频率,选择合适的缓存策略。

因此,缓存是前端性能优化的重要组成部分!

总结

  • localStorage:适合存储小量、不敏感的数据
  • sessionStorage:适合存储会话期间的数据
  • IndexedDB:适合存储大量结构化数据
  • Service Worker:适合缓存静态资源和 API 响应
  • 缓存策略:合理设置过期时间,定期清理过期缓存
  • 缓存键管理:使用统一的命名规范,避免缓存键冲突
  • 错误处理:处理存储空间不足等异常情况
  • 性能监控:监控缓存命中率,不断优化缓存策略

前端缓存是性能优化的关键。

目录

  1. 前端缓存策略最佳实践:LocalStorage 与 Service Worker
  2. 常见误区
  3. 为什么你需要这个?
  4. 反面教材
  5. 正确的做法
  6. 核心建议
  7. 总结
  • 免费图片AI生成工具免费生成了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 免费图片视频在线生成30秒,将你的创意变成现实开始设计
  • X/Twitter免费视频下载器免登陆无限额度免费视频解析下载了解详情
  • 100+免费在线小游戏爽一把
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • Xinference 大模型部署与分布式推理框架使用指南
  • 魔搭社区:探索 LLM 大模型的应用与微调实践
  • HTTP 应用层协议详解与简易服务器实现
  • Trae AI 编程工具使用指南与竞品对比分析
  • Flutter Web 混合开发最佳实践
  • FAIR plus 机器人全产业链接会:智启未来链动全球
  • 1Panel 部署 Node+MongoDB+Nginx 项目实操及避坑指南
  • 掌握三大 AI 设计技能,前端独立实现产品全流程
  • 基于 Nuxt 与 WebAssembly 的浏览器端图片压缩工具实现
  • 企业为何需要私有化专属大模型:从 ChatGPT 到私有化部署
  • GESP-C++四级考试核心知识点与编程模板
  • TypeScript 高级技巧:提升代码类型安全
  • GitHub Copilot 学生认证及实战使用指南
  • Android 开发中依赖库版本管理与环境配置最佳实践
  • 大模型应用实战:原理、场景与 Prompt 技巧
  • C++进阶:从裸指针到智能指针的内存管理进化
  • 无人机路径规划算法详解
  • 自然语言处理在金融领域的应用与实战
  • VS Code 前端开发必备插件指南:10 款工具与配置详解
  • OpenHarmony 下 Flutter 库 discord_interactions 适配指南

相关免费在线工具

  • Keycode 信息

    查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online

  • Escape 与 Native 编解码

    JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online

  • JavaScript / HTML 格式化

    使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online

  • JavaScript 压缩与混淆

    Terser 压缩、变量名混淆,或 javascript-obfuscator 高强度混淆(体积会增大)。 在线工具,JavaScript 压缩与混淆在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online