manifest.json 的 start_url 和 display 影响启动画面是否显示：display 必须为 "standalone" 或 "fullscreen"，start_url 需为可离线缓存的相对路径，且需已注册 Service Worker；仅 background_color 和 icons 控制样式，图标须为 PNG、路径可访问、颜色为合法十六进制。
为什么 manifest.json 里的 start_url 和 display 会影响启动画面显示
启动画面（splash screen）的显示机制，其实和HTML或CSS关系不大。它更像是一个“系统级”的开关，由PWA的manifest.json文件配合浏览器的原生逻辑共同决定。简单来说，如果start_url指向了一个无法立即加载的页面，或者display模式被设置成了"browser"，那么系统从一开始就不会为你展示启动画面。
那么，具体需要满足哪几个条件呢？这里有三条硬性规则：
- display 必须设置为 "standalone" 或 "fullscreen"。
- start_url 必须是相对路径，并且确保它能被离线缓存（例如 "./index.html"，直接使用 "https://example.com/"这样的绝对路径通常不行）。
- 最关键的一点：页面在首次加载时，Service Worker就必须已经成功注册，并且manifest.json文件也已经被正确链接。
manifest.json 中哪些字段真正控制启动画面样式
很多人会误以为name或short_name会影响启动画面的内容，其实它们只作用于应用安装后的标题栏。真正掌控启动画面视觉样式的，只有两个字段：background_color和icons。
浏览器会自动从你提供的icons数组里，挑选出最匹配设备屏幕密度和尺寸的那一个图标来显示（因此，通常建议至少准备192x192和512x512两种尺寸的PNG图标）。
这里有三个细节需要特别注意：
- background_color 必须使用合法的十六进制颜色值（比如 "#ffffff"），不支持rgb()或CSS变量。
- 所有icons条目中的src路径，都必须确保能被浏览器成功获取（建议使用绝对路径或根相对路径，例如 "/icons/icon-192.png"）。
- 图标格式目前只认PNG，使用SVG或WebP可能会导致在部分安卓版本上静默失败，从而回退到默认样式。
为什么本地开发时看不到启动画面
在本地开发环境调试启动画面，常常会让人感到困惑。原因主要有两点：首先，像Chrome和Edge这类浏览器，在非HTTPS环境下（即便是localhost）会默认禁用splash screen功能。其次，也是最关键的一点：启动画面只在用户「从主屏幕图标启动应用」时才会触发，单纯在浏览器标签页里刷新页面（按F5）是无法重现这个效果的。
想要验证它是否正常工作，可以遵循以下步骤：
- 首先，打开Chrome DevTools，进入Application面板下的Manifest标签页，确认你的manifest文件已成功加载且没有任何警告。
- 在桌面版Chrome中访问你的站点，点击地址栏右侧的“安装”按钮，将应用安装到桌面。之后，关闭浏览器，从新创建的桌面图标启动应用。
- 在移动端（如Android Chrome），需要先访问你的站点，然后通过浏览器菜单选择“添加到主屏幕”，最后从主屏幕的图标打开应用。
Service Worker 不注册会导致启动画面一闪而过
启动画面能持续多久，取决于页面首次DOMContentLoaded事件发生的时机。但这一切的前提是，Service Worker必须已经激活并接管了页面。如果你的Service Worker注册代码写在了window.addEventListener('load', ...)里，很可能会错过最佳时机，导致启动画面刚出现就立刻消失了。
立即学习“前端免费学习笔记（深入）”；
比较推荐的写法是：
- 在HTML文档的底部立即执行注册：
na vigator.serviceWorker.register('/sw.js').catch(e => console.error('SW reg failed:', e));
- 在
sw.js文件中，至少需要监听并响应fetch事件，确保缓存了start_url对应的HTML文件。
- 注意，不要过度依赖
skipWaiting()或clients.claim()这类方法来强行激活新的Service Worker。不当使用反而可能导致关键资源加载中断，使得启动画面提前结束。
最后需要明确的是，启动画面本身并不受DOM控制，所有定制都必须在manifest声明阶段完成。而其中最容易被忽略的一个陷阱，就是图标路径的可访问性——一个返回404的icon，会让整个splash screen默默回退为纯色背景，并且控制台很可能不会给出任何错误提示，排查起来相当棘手。
