必须启用Safari Web检查器Application面板调试：先勾选高级设置中“显示开发菜单”，再打开网页检查器→Application标签，右键Waiting状态Service Worker选择“Skip Waiting”，并核对Cache Storage缓存内容与离线响应逻辑。
当你在Safari中开发PWA却无法触发离线页面、缓存不生效或Service Worker始终卡在waiting状态时，必须启用Web检查器的Application面板进行可视化调试——Safari不提供Chrome那样的实时更新开关，所有调试动作都依赖开发者工具的底层接口和手动干预。
启用Safari开发者工具并打开Application面板
点击Safari → 设置 → 高级，勾选【在菜单栏中显示‘开发’菜单】。这一步不可跳过，否则后续所有调试入口均不可见。
打开任意网页（推荐用safari://extensions或空白页），点击顶部菜单栏中的“开发”→“显示网页检查器”，再切换到Application标签页。若该标签页缺失，说明开发菜单未启用或当前页面不支持Service Worker上下文（如file://协议页）。
查看并强制激活等待中的Service Worker
在Application面板左侧边栏展开Service Workers，右侧会列出所有已注册实例及其状态：Activated（正在控制页面）、Waiting（新版本就绪但未接管）、Installing（安装中）。
若目标Service Worker显示为Waiting，说明新sw.js已加载但浏览器未自动激活——Safari默认不会跳过waiting阶段，必须手动干预。
右键该条目，选择【Skip Waiting】。这会立即终止旧Worker、激活新Worker，并使其开始拦截fetch请求。注意：【此操作不可逆，旧版本缓存策略将立即失效】。
检查预缓存资源是否写入Cache Storage
展开左侧Cache Storage，查看是否存在以你PWA域名命名的缓存（如https://my-pwa.dev），或自定义的CACHE_NAME（如my-pwa-cache-v1）。
若列表为空，说明install事件未成功执行：可能原因包括sw.js路径错误（必须是根相对路径如/sw.js）、caches.open()被拒绝（如页面未通过HTTPS加载）、或event.waitUntil()内Promise被reject导致安装中断。
点击某缓存名称，右侧会显示所有已缓存URL。逐个核对index.html、manifest.json、关键JS/CSS是否在列。缺失任一HTML入口文件，离线访问必然失败。
模拟离线环境并验证fetch响应逻辑
在Application面板顶部工具栏，点击【Offline】开关（图标为断开的Wi-Fi信号）。此时所有网络请求将被阻断，仅能依赖缓存或Service Worker主动响应。
刷新页面，观察Network面板：若HTML返回200且来自service-worker，说明fetch事件已正确拦截；若返回“Failed to load resource”，则证明caches.match()未命中且未fallback到fetch()调用——检查fetch事件监听器是否注册、匹配逻辑是否排除了导航请求（request.destination === 'document'）。
在Console中输入navigator.serviceWorker.controller，确认返回对象存在且state为activated。若返回null，代表当前页面未被任何Service Worker控制，需重新检查注册代码是否在window.load后执行、sw.js是否返回200状态码。
清除异常残留并重建注册环境
方法一：仅清空当前域名数据
在Application → Clear storage面板中，勾选【Website data】和【Cache storage】，点击【Remove now】。这会删除该域名下所有缓存、Cookie及Service Worker注册元数据，但保留其他网站数据。
方法二：全量重置（适用于反复调试失败）
点击Safari顶部菜单栏历史记录 → 清除历史记录… → 时间范围选【所有历史记录】→ 必须勾选【Cookie 与网站数据】→ 点击【清除历史记录】。Safari将自动退出并重启，所有Service Worker注册信息被系统级清空。
重启后首次访问PWA页面，务必在Console中执行navigator.serviceWorker.register('/sw.js')并确认Promise resolve，再检查Application面板是否出现新注册项。这一步验证HTTPS环境、路径合法性及脚本语法正确性。
