CSS必须在Service Worker的install阶段用cache.addAll()预缓存绝对路径资源，否则首次离线访问必然白屏或样式断裂；因CSS是渲染阻塞资源，HTML解析时同步等待其加载，断网且未提前缓存则请求失败导致样式缺失。
CSS 必须在 Service Worker 的 install 阶段预缓存，否则首次离线访问必然白屏或样式断裂。这不是缓存逻辑写错了，而是时机根本没对上——HTML 解析到 <link rel="stylesheet" href="styles.css"> 时会同步阻塞等待，此时若网络已断且 CSS 还没进缓存，请求直接失败，浏览器拿不到任何样式内容。
install 阶段必须用 cache.addAll() 预缓存 CSS
渲染阻塞资源（CSS、JS、HTML）不能靠 fetch 事件里“按需缓存”，那太晚了。必须在 install 阶段一次性把所有关键 CSS 路径塞进缓存：
-
cache.addAll()是原子操作：列表里任一 URL 失败（404、跨域、路径错），整个 install 就失败，Service Worker 不会激活 - 路径必须和 HTML 中
<link href="">的值**完全一致**，且必须是绝对路径：比如 HTML 写的是/css/main.css，缓存列表里就不能写css/main.css或./css/main.css - 构建后路径变了？Webpack/Vite 生成的哈希文件名（如
/css/main.a1b2c3.css）必须填进缓存列表，不能写源码里的main.css - 带查询参数的 URL（如
styles.css?v=2.1）会被当作独立缓存键；后续请求必须含相同参数才能命中，不推荐——改CACHE_NAME更可靠
fetch 事件里要显式响应 CSS 请求
缓存了 CSS 不等于它能被用上。Service Worker 还得在运行时把 CSS 请求真正导向缓存：
- 必须监听
fetch事件，并用event.respondWith()显式接管 - 建议加类型过滤：
if (event.request.destination === 'style')，避免误伤图片、API 等其他请求 - 典型写法：
caches.match(event.request).then(r => r || fetch(event.request))，即“有缓存就用，没有再走网络” -
index.html本身也必须被cache.addAll()缓存，否则连 HTML 都打不开，CSS 根本没机会被请求
开发阶段 CSS 缓存总不生效？先看协议和环境
90% 的“缓存无效”问题卡在启动方式上：
立即学习“前端免费学习笔记（深入）”；
-
file://协议下 Service Worker 完全不工作，这是浏览器强制限制，本地双击 HTML 文件必失败 - vue-cli、Vite 等工具的开发服务器（
npm run serve）默认禁用 Service Worker，防止热更新被缓存劫持 - 正确本地测试姿势：先
npm run build，再用npx serve dist启一个 HTTP 服务，并用 Chrome 无痕窗口访问 - 如果之前注册过旧版 SW，需手动进 DevTools → Application → Service Workers 点击 “Unregister”，再刷新
最容易被忽略的一点：CSS 路径写错时，cache.addAll() 不报错也不提示，只在 DevTools → Application → Cache Storage 里找不到对应文件——这意味着你得主动去那里验证缓存是否真进去了，而不是只看控制台有没有 log。
