HTML5提供manifest和Service Worker两种离线缓存机制：manifest已废弃，需配置cache.manifest文件并设置MIME类型；Service Worker是现代推荐方案，通过sw.js注册、install预缓存、fetch拦截及activate清理实现精细控制。
如果您希望网页在离线状态下仍能正常加载资源，HTML5 提供了两种主流的缓存机制：传统的 Application Cache（manifest）和现代的 Service Worker。以下是实现文件缓存的具体方法：
一、使用 manifest 文件配置离线缓存
manifest 是 HTML5 早期引入的缓存机制，通过一个清单文件声明需要缓存的资源，浏览器据此在首次访问时下载并存储指定文件。该方式已废弃但仍在部分旧环境使用。
1、创建一个名为 cache.manifest 的纯文本文件，内容以 CACHE MANIFEST 开头。
2、在 manifest 文件中添加 CACHE: 段落，其后逐行列出需缓存的 HTML、CSS、JS、图片等资源路径。
立即学习“前端免费学习笔记（深入）”；
3、在网页的 标签中添加 manifest="cache.manifest" 属性。
4、确保 Web 服务器将 .manifest 文件的 MIME 类型设置为 text/cache-manifest。
5、用户首次访问页面后，浏览器自动下载并缓存清单所列资源；后续离线访问时，直接从本地缓存读取。
二、使用 Service Worker 配置高级缓存策略
Service Worker 是运行在浏览器后台的脚本，可拦截网络请求并自定义响应逻辑，支持精细控制缓存时机、更新行为与匹配规则，是当前推荐的标准方案。
1、在网站根目录下创建 sw.js 文件，并确保其可通过 HTTPS 或 localhost 访问。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur
2、在主页面 JavaScript 中调用 navigator.serviceWorker.register('sw.js') 注册服务工作线程。
3、在 sw.js 中监听 install 事件，使用 caches.open() 创建缓存空间，并调用 cache.addAll() 预缓存关键资源列表。
4、监听 fetch 事件，在其中判断请求是否命中缓存；若命中则返回 cache.match() 结果，否则发起网络请求并可选择性地将响应写入缓存。
5、在 activate 事件中调用 caches.delete() 清理旧版本缓存，确保缓存更新生效。
三、验证缓存是否生效
通过浏览器开发者工具可确认缓存机制是否按预期运行，避免因配置错误导致离线失败或资源未更新。
1、打开 Chrome 或 Edge 浏览器，按 F12 进入开发者工具，切换到 Application 面板。
2、在左侧菜单中查看 Manifest（仅 manifest 方案）或 Service Workers（仅 SW 方案），确认状态为 Activated and Running 或已显示缓存名称。
3、点击 Cache Storage，展开对应缓存名，检查其中是否包含预设的 HTML、CSS 等文件条目。
4、启用 Offline 模式（Network 面板中勾选），刷新页面，观察资源是否仍能加载且无红色 404 请求。
5、在 Network 面板中查看请求的 Size 列，若显示 from ServiceWorker 或 from disk cache，表明缓存已介入响应。
