scope字段限定PWA作用范围,必须是start_url的父路径或同级路径且为以/开头的相对路径;它决定Service Worker控制边界、路由匹配及安装权限,子路径部署时需显式声明并注意尾部斜杠。

scope 字段用于限定 PWA 的 URL 作用范围,决定哪些页面属于该 Web App、能响应“添加到主屏幕”行为、受其 manifest 和 Service Worker 管理。它不是可选装饰项,而是影响路由匹配、导航拦截和安装权限的关键配置。
scope 必须是 start_url 的父路径或同级路径
scope 值必须为相对路径(以 / 开头),且不能比 start_url 更深。例如:
- 若
"start_url": "/app/home",则"scope": "/app/"✅ 合法(父目录) - 若
"start_url": "/app/home",则"scope": "/app/home"✅ 合法(同路径,但不推荐——太窄) - 若
"start_url": "/app/home",则"scope": "/"✅ 合法(根路径,最宽泛) - 若
"start_url": "/app/home",则"scope": "/app/home/dashboard"❌ 非法(比 start_url 更深,浏览器拒绝解析 manifest)
scope 决定 Service Worker 的控制边界
注册的 Service Worker 只能接管 scope 路径下的页面请求。比如:
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
-
"scope": "/myapp/"→ SW 只能拦截/myapp/、/myapp/page.html、/myapp/api/data.json等请求 -
"scope": "/"→ SW 可拦截全站请求(前提是注册路径也允许,如navigator.serviceWorker.register('/sw.js', {scope: '/'})) - scope 不匹配会导致:页面无法被 SW 控制、fetch 事件不触发、离线缓存失效、安装提示不出现
子路径部署时 scope 要显式声明
项目部署在子路径(如 https://example.com/myapp/)时,不能依赖默认行为。必须明确设置:
-
"start_url": "./"或"start_url": "/myapp/" -
"scope": "/myapp/"—— 注意结尾斜杠,否则可能被截断为/myapp(无尾斜杠会被浏览器自动补,但行为不一致,建议写全) - 同时确保
中的 href 与部署路径一致
scope 与 iOS 的兼容补充
Safari 不读取 manifest 中的 scope,但会按 + apple-touch-icon 路径推断作用域。为保 iOS “添加到主屏幕”正常:
- 确保所有资源(尤其是图标、start_url 页面)都位于 scope 定义的路径下
- 避免在 scope 外提供
apple-touch-icon,否则可能引发跨路径加载失败 - 不建议用
scope: "/sub/"却把 manifest 放在根目录——路径错位将导致 Chrome 拒绝安装
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










