workbox 通过 generatesw 和 injectmanifest 两种方式简化 service worker 开发:前者适用于标准 pwa 场景,自动生成预缓存清单与策略;后者支持深度定制,如集成 web push 或自定义 fetch 逻辑;同时强调按资源类型(静态资源、图片、api)分配缓存策略,并要求路由匹配精准以避免误缓存。

Service Worker 本身需要手动监听 install、activate、fetch 等事件,写法繁琐且容易出错。Workbox 就是为解决这个问题而生的——它把缓存策略、路由匹配、预缓存、过期控制等能力封装成可复用模块,让你用几行配置代替上百行底层代码。
用 generateSW 快速生成标准 Service Worker
适合大多数 PWA 场景,尤其静态资源稳定、缓存策略明确的项目。只需定义构建路径和缓存规则,Workbox 自动注入预缓存清单并生成完整 sw.js:
- 在 webpack 或 vue.config.js 中引入 GenerateSW 插件,指定输出路径(如
sw.js)和要预缓存的文件类型(html/js/css等) - 通过
runtimeCaching数组声明运行时策略:比如对/api/请求用NetworkFirst,对图片用CacheFirst并加ExpirationPlugin - 启用
skipWaiting: true和clientsClaim: true,确保新版本安装后立刻生效,页面不需刷新就能用上最新缓存
用 injectManifest 实现深度定制
当你需要在 Service Worker 中集成 Web Push、BackgroundSync、自定义 fetch 处理逻辑,或对缓存行为做精细控制时,injectManifest 更合适:
Java开发手册规约集合,基于阿里巴巴Java开发手册(嵩山版)。 涵盖7大维度:编程规约、异常日志、单元测试、安全规约、MySQL数据库、工程结构、设计规约。 当用户需要:(1) 编写或审查Java代码 (2) 检查命名/代码规范 (3) 处理异常和日志 (4) 编写单元测试 (5) 安全编码 (6) 数据库设...
- 先写一个基础 sw.js 文件,在其中预留
self.__WB_MANIFEST占位符 - 配置插件指向该源文件,Workbox 会把构建生成的预缓存清单自动注入进去
- 你可以在同一文件里自由添加其他事件监听器,比如监听
push或sync,或对特定请求做特殊响应
按资源类型分配缓存策略
不能所有请求都走同一种策略。Workbox 的核心价值之一就是让策略选择变得直观:
- 静态资源(JS/CSS/HTML/字体)→ CacheFirst + 预缓存:文件名含哈希,天然支持版本淘汰
- 图片 → CacheFirst + ExpirationPlugin:限制最大数量(如 60 张)和保留时间(如 30 天),防缓存膨胀
- API 接口 → 根据业务选:NetworkFirst(强一致性,如用户资料)、StaleWhileRevalidate(兼顾速度与更新,如新闻列表)
路由匹配必须精准,避免误缓存
宽泛匹配(比如 /.*/)极易导致跨域请求、第三方 SDK 资源被错误拦截,引发白屏或功能异常:
- 优先用函数方式匹配:检查
url.origin是否为你自己的 API 域名,再结合request.destination判断资源类型 - 正则表达式要带锚点和明确前缀,例如
^https://api.example.com/v1/,而不是/api/ - 第三方资源(如微信 JS-SDK、地图 SDK)一律排除,不进缓存
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










