当前位置:首页 > 文章列表 > 文章 > 前端 > PWA需要哪些HTML支持?基础解析

PWA需要哪些HTML支持?基础解析

2026-04-24 12:47:37 0浏览 收藏
PWA的HTML支持看似简单,实则处处是关键“硬性开关”:必须在head中用带rel="manifest"的link标签声明以/开头的manifest路径,配置正确的viewport(含width=device-width且严禁user-scalable=no),全程运行在HTTPS或localhost环境下,并在manifest.json中显式定义theme_color、background_color和standalone/minimal-ui显示模式——任何一项缺失或写错(比如manifest路径不以/开头、viewport被JS动态注入、或用了自签名证书),都不会报错,但用户将完全无法触发“添加到主屏幕”,PWA安装流程直接卡死在第一步。

PWA需要哪些HTML支持_渐进式网页应用基础【介绍】

manifest.json 文件必须通过 link 标签声明在 HTML 中

没有这行,浏览器根本不会识别你的 PWA。常见错误是把 manifest.json 放错路径,或漏掉 rel="manifest" 属性。

正确写法(放在 内):

<link rel="manifest" href="/manifest.json">
  • href 必须是相对根路径(以 / 开头),否则 Service Worker 无法正确读取
  • 文件 MIME 类型需为 application/manifest+json,Nginx/Apache 要配置好,否则 Chrome 会静默忽略
  • 不要用