浏览器仅在满足HTTPS、合规manifest.json、成功注册并激活的Service Worker、用户停留≥30秒及至少一次交互等全部条件后，才可能触发beforeinstallprompt事件；iOS则完全不支持自动提示，需手动添加。
浏览器不会自动弹出“添加到主屏幕”提示，哪怕你写了 manifest.json 和 sw.js —— 它只在满足一整套硬性条件后，才可能触发横幅；iOS 则压根不支持自动横幅，只能靠用户手动操作。
manifest.json 必须能被正确加载且格式合规
Chrome、Edge 等浏览器默认只请求 /manifest.json，路径错、404、MIME 类型不对，都会静默失败。
-
manifest.json强烈建议放在网站根目录（即https://yoursite.com/manifest.json可直接访问） -
<link rel="manifest" href="/manifest.json">必须写在<head>中，href以/开头，不能用相对路径如"manifest.json" - 服务器需返回
Content-Type: application/manifest+json，Nginx/Apache 要显式配置，Vercel/Netlify 默认支持 -
short_name字段必须存在且 ≤12 字符（含空格），name建议 ≤30 字符；二者都缺或含不可见 Unicode，会直接解析失败 - 至少提供一个 ≥192×192 的 PNG 图标，且
icons数组中purpose可省略，但sizes和src不可为空
Service Worker 注册必须成功且运行在安全上下文
navigator.serviceWorker 在 HTTP（非 localhost）下是 undefined，注册根本不会执行；即使注册了，路径错、返回 404 或 MIME 类型不是 application/javascript，控制台也常无报错，只静默失败。
- 开发时可用
http://localhost:3000，但换成http://192.168.x.x:3000就失效 —— 非 localhost 的 HTTP 域名不被认可 - 注册代码必须放在
window.addEventListener('load', ...)中，不能在 DOMContentLoaded 或更早时机调用 - 确保
sw.js文件实际存在于你写的路径（如/sw.js），且可通过浏览器直接访问并返回 200 - 注册后可在 Chrome DevTools 的 Application → Service Workers 面板查看是否激活，状态为 “Activated and is running” 才算成功
beforeinstallprompt 事件必须手动捕获和触发
这个事件只触发一次，且仅在满足所有前提（HTTPS + manifest + SW + 用户停留 ≥30 秒 + 至少一次交互）后才发生。错过就没了，也不能靠定时器或异步回调补救。
立即学习“前端免费学习笔记（深入）”；
- 必须在事件触发时立即调用
e.preventDefault()，否则浏览器会按默认逻辑处理（往往直接忽略） - 把事件对象缓存到全局变量（如
deferredPrompt），等用户点击按钮再调用deferredPrompt.prompt() -
deferredPrompt.prompt()必须由用户手势（click/tap）触发，不能包在setTimeout、fetch回调或 Promise.then 里 - 调用后必须立刻清空
deferredPrompt = null，因为该方法只能调一次，重复调用会抛错InvalidStateError
移动端 iOS 的安装引导完全无法自动触发
iOS Safari 不支持 beforeinstallprompt 事件，也不显示任何横幅。所谓“PWA 安装”，对 iOS 用户来说，就是手动操作：打开分享菜单 → 滚动到底部 → 点“添加到主屏幕”。你唯一能做的，是检测 navigator.standalone === false && /iPad|iPhone|iPod/.test(navigator.userAgent)，然后展示一个清晰的图文指引。
- 不要尝试用 JS 模拟点击或唤起分享面板 —— iOS 不允许非用户手势触发此类 UI
- 避免在页面加载初期就弹出浮层干扰体验；建议等用户滚动一段距离或点击某区域后再显示提示
- 图标尺寸要同时满足 iOS 要求（推荐加 180×180 Apple Touch Icon：
<link rel="apple-touch-icon" href="/icon-180.png">）
最常被忽略的一点：所有检查项（manifest 加载、SW 激活、用户交互）必须串行完成，且中间不能刷新页面 —— 刷新后 beforeinstallprompt 不会重发，除非重新满足全部条件。
