PWA应用的显示模式由manifest.json中display字段控制,可选值包括standalone(隐藏浏览器UI,最推荐)、fullscreen(全屏沉浸式)、minimal-ui(保留最小控件)和browser(标准标签页)。

PWA 应用的显示模式由 manifest.json 中的 display 字段控制,它决定应用安装后以何种界面形式运行——是像网页、还是更接近原生 App。这个配置直接影响用户首次打开时的体验和感知。
display 可选值及实际效果
"standalone"
隐藏地址栏、导航按钮等浏览器 UI,启动为独立窗口,状态栏颜色由theme_color控制。这是最常用、最推荐的模式,能让用户明确感知“这不是网页”。"fullscreen"
完全隐藏系统状态栏(如时间、信号),画面铺满整个屏幕。适合游戏或沉浸式内容,但部分 Android 设备可能因遮挡关键信息而不推荐常规业务使用。"minimal-ui"
保留最小化浏览器控件(例如返回按钮),适合需要临时跳转回浏览器场景,但已不算严格意义上的 PWA(Lighthouse 检测可能不给满分)。"browser"
保持标准浏览器标签页行为,不触发“添加到主屏幕”提示,也不具备 PWA 特性,仅作兼容 fallback。
配置要点与常见陷阱
-
display必须写在manifest.json根层级,且值为字符串(不能加空格或引号外字符) - 在
<head>中正确引入 manifest:<link rel="manifest" href="/manifest.json">,路径必须可访问(建议用绝对路径) - iOS Safari 不认
display字段,需额外加<meta name="apple-mobile-web-app-capable" content="yes">才能启用独立模式 -
start_url必须在scope范围内,否则 standalone 模式可能降级为 browser 模式 - 修改
display后需清除浏览器缓存并重新安装,旧安装不会自动更新该行为
典型 manifest 片段示例
立即学习“Java免费学习笔记(深入)”;
{
"name": "我的记账工具",
"short_name": "记账本",
"start_url": "/",
"display": "standalone",
"theme_color": "#4a6fa5",
"background_color": "#f8f9fa",
"icons": [
{ "src": "/icons/icon-192.png", "sizes": "192x192", "type": "image/png" },
{ "src": "/icons/icon-512.png", "sizes": "512x512", "type": "image/png" }
]
}不复杂但容易忽略


















