uni-app怎么去除启动时的白屏等待时间-uni-app-PHP中文网

根本无法彻底消除白屏，但可压缩至用户几乎无感：关键在于确保onlaunch不阻塞、js初始化不卡死、vue实例及时挂载；常见原因包括未await异步调用、pages.json路径或style非法、manifest.json与publicpath配置错位、ios wkwebview初始化延迟等。

uni-app怎么去除启动时的白屏等待时间

根本去不掉白屏等待时间，但能把它压缩到用户几乎感知不到的程度——关键不是“去掉”，而是让 JS 初始化、资源加载、Vue 挂载这三步不卡死、不阻塞、不静默失败。

这是最隐蔽也最普遍的白屏原因：JS 线程停在 onLaunch，Vue 实例压根没挂载，页面连 DOM 都没开始生成。

uni.getStorage({ key: 'token' }) 必须写成 await uni.getStorage({ key: 'token' })，否则 Promise 被丢弃，后续逻辑跳过，控制台还不报错
uni.getSystemInfoSync() 返回对象后，别直接访问 res.model（iOS 16+ 已改用 res.deviceModel），取不到就 undefined，链式调用一崩到底
所有 uni.xxx 异步方法（request、getNetworkType、checkIsSupportSoterAuthentication）在 onLaunch 中必须 await
真机调试时，在 onLaunch 开头加 console.log('onLaunch start')，如果这句都不输出，问题在更早阶段（比如 main.js import 失败或 store 循环依赖）

小程序和 App 端对 pages.json 容错率极低，错位、大小写、斜杠方向、空 style 都会导致路由系统初始化失败，且控制台静默无提示。

uni-app

uni-app 是基于 Vue 的跨端开发框架，适合开发 H5、App、小程序、鸿蒙和多端业务应用。

下载

确认 "list" 第一项的 "path" 真实存在，例如 "pages/index/index" 对应 src/pages/index/index.vue，不能是 Pages/Index/Index.vue（大小写敏感）
"style" 字段必须是合法 JSON 对象，禁止写成 "style": "" 或 "style": {}；至少写 "style": {"navigationBarTitleText": "首页"}
H5 端可手动访问 /pages/index/index.html 测试是否 404；App 端打包后白屏，优先检查该页面是否被构建进 unpackage/dist/build/app-plus/
删掉 unpackage 和 node_modules，重装依赖再打包——HBuilderX 4.66.2025051912+ 有已知缓存 bug，旧基座残留会引发白屏

开发时跑得通，打包后白屏？90% 是环境路径没切到生产模式，app-service.js 加载失败，WebView 不报错，只留白屏。

manifest.json 中 "app-plus" 下的启动图路径必须是绝对路径，且文件真实存在于 unpackage/dist/build/app-plus/static/，例如 "image": "/static/splash.png"
vue.config.js 若存在，生产环境的 publicPath 必须设为 './'；设成 '/' 或完整域名会导致 JS/CSS 加载 404
manifest.json 的 "h5" 节点中，"router":{"base":"./"} 必须存在，尤其部署到子目录时，否则路由跳转 404
Android 推荐用 .9.png，iOS 必须用 Storyboard 启动图，两者路径、格式、适配方式完全不同，混用必白屏

iOS 首次冷启动时，WKWebView 加载 JS 引擎比 Android 慢得多，常导致 Vue 尚未 ready 就开始 render，结果 DOM 空白。

在 App.vue 的 onLaunch 中加兜底逻辑：if (uni.getSystemInfoSync().platform === 'ios') setTimeout(() => location.reload(), 800)
首页组件必须极简：不 import 大型图表库、不发多个并发请求、不加载未压缩的字体文件
避免在 onReady 发起网络请求——此时页面虽已渲染，但数据还没来，视觉上仍是白屏；应提前到 onLoad 或 onLaunch（带 await）中处理