PWA 项目通过 Lighthouse 可安装性审计需满足三硬性要求：1. manifest.json 必含 name/short_name、start_url、display、icons、background_color 与 theme_color；2. icons 数组须含 192×192 和 512×512 PNG 图标，src 为可访问绝对路径，sizes 格式正确；3. HTML 中正确引用 manifest，服务器返回 application/manifest+json MIME 类型且部署于 HTTPS 环境。
要让 PWA 项目完全通过 Lighthouse 或 Chrome 的可安装性审计，Manifest 配置必须满足明确、硬性的结构与内容要求——不是“差不多就行”，而是每一条都得达标。核心就三点：字段齐全、路径可访问、尺寸合规。
必需字段一个不能少
manifest.json 必须包含以下五个字段，缺一不可：
-
name 或 short_name：至少填一个；推荐两个都写，
short_name用于图标下方空间受限时显示 -
start_url：必须是相对路径（如
"/"）或绝对路径（如"/app/"），且该 URL 能返回有效 HTML 页面 -
display：只能是
"standalone"、"fullscreen"或"minimal-ui"；不能用"browser" -
icons 数组：至少含两项，且必须覆盖
192x192和512x512两种尺寸的 PNG 图标 -
background_color 与 theme_color：两者都要写，颜色值支持十六进制（如
"#ffffff"）、rgb 或 rgba
图标配置必须严格达标
图标不是“有图就行”，关键细节决定能否过审：
- 每个 icon 对象必须含
src（绝对路径优先）、sizes（格式为"192x192"，不能写成192或[192,192]）、type（固定为"image/png"） - 图标文件本身必须是纯 PNG 格式，无透明通道问题；192×192 和 512×512 两个尺寸必须真实存在、可直接通过浏览器访问（HTTP 状态码 200）
- 部署在子目录时，
src建议写完整绝对 URL（如"https://your.com/app/icon-192x192.png"），避免因 base 路径错位导致 404
HTML 引用与部署环境同步验证
Manifest 文件生效的前提是它被正确加载：
- 在页面
中添加：；href必须指向实际可访问的路径，不能是 404 或重定向 - 确保服务器以
application/manifest+jsonMIME 类型返回 manifest.json（Nginx/Apache 需显式配置） - 必须运行在 HTTPS 环境下（本地
localhost除外）；HTTP 站点即使 manifest 全对，也会被浏览器直接拒绝安装 - 用 Chrome DevTools 打开 Application → Manifest 面板，确认无解析错误，图标预览能正常加载，各字段值准确显示
