07.2.4.9 性能优化与典型踩坑
所属:全栈开发面试题库 / 07 端侧与桌面开发 / 07.2 跨平台移动开发 / 07.2.4 uni-app
本节要解决的问题
- 首屏与分包加载怎么优化,代码与资源体积怎么控?
- setData 数据量与频率的成本模型是什么,长列表怎么渲染?
- 图片与静态资源优化有哪些手段?
- nvue 的使用边界在哪里?
- WebView 数量与内存怎么管?
- 启动优化与 splash 怎么调?
- 白屏、兼容性与线上监控怎么建?
- 样式、事件、生命周期、条件编译、打包配置有哪些典型踩坑?
版本前提:本节以传统 uni-app(Vue2/Vue3)App 端 WebView 渲染 + nvue 为基线;uni-app x 性能差异见 07.2.4.8。具体 API 名、组件名、限额随版本变化,标「待确认」处以 DCloud 官方文档为准。
覆盖范围
| 知识域 | 关键内容 |
|---|---|
| 启动与包体 | 首屏、分包、资源体积、代码压缩 |
| 数据通信 | setData 成本模型、长列表、虚拟列表 |
| 资源优化 | 图片、静态资源、字体、缓存 |
| 渲染边界 | nvue 适用、WebView 数量、内存 |
| 线上治理 | 白屏、兼容性、监控、告警 |
| 典型踩坑 | 样式、事件、生命周期、条件编译、打包配置 |
题号索引
| 题号区间 | 主题 |
|---|---|
| 001-003 | 首屏、分包、包体优化 |
| 004-006 | setData 成本模型、长列表、虚拟列表 |
| 007-008 | 图片与静态资源优化 |
| 009-010 | nvue 使用边界与 WebView 内存 |
| 011-012 | 启动优化与 splash |
| 013-014 | 白屏、兼容性与线上监控 |
| 015-016 | 典型踩坑清单与综合排查 |
07.2.4.9-001 uni-app 首屏加载慢怎么优化?
一句话结论
首屏慢要拆成"启动 + 首屏数据 + 首屏渲染"三段分别优化:启动靠减少初始化与 splash 配置,首屏数据靠预取与缓存,首屏渲染靠减少首屏 DOM 复杂度与分包。
概念解释
首屏时间不是单一指标,用户感知从"点图标"到"看到可交互内容"分三段:一是 App 启动(原生壳初始化、WebView 加载);二是首屏数据请求(接口等待);三是首屏渲染(DOM 构建、图片解码)。每段都有对应优化手段。
启动段:减少 App.onLaunch 里的同步任务、延迟非关键 SDK 初始化、配置 splash 屏避免白屏。数据段:接口预取(onLaunch 时并行拉)、本地缓存首屏数据先渲染再后台刷新、首屏接口合并。渲染段:首屏 DOM 扁平化、避免首屏大量图片、分包加载非首屏资源。
量化口径上,建议把首屏拆成三个可测指标:启动到首屏 DOM ready(前端可测)、首屏接口返回(网络层)、首屏可交互(用户感知)。三段分别打点上报,才能定位慢在哪一段,而不是笼统说"首屏慢"。常见错误是只优化接口,但实际瓶颈在 WebView 初始化或首屏图片解码。
原理流程
用户点图标
→ App 启动(原生壳 + WebView 初始化)
→ onLaunch 初始化(延迟非关键任务)
→ 首屏页面加载
→ 首屏数据(缓存先渲染 + 后台刷新)
→ 首屏渲染(少 DOM + 懒加载图片)
→ 可交互
代码或图示
| 段 | 优化点 |
|---|---|
| 启动 | 延迟初始化、splash、减少 onLaunch 同步任务 |
| 数据 | 预取、缓存、接口合并 |
| 渲染 | 扁平化、图片懒加载、分包 |
常见误区
- 误区:首屏慢就是接口慢;正解:启动、数据、渲染三段都要量,分别优化。
- 误区:首屏数据全靠接口;正解:先用本地缓存渲染骨架,后台刷新,用户感知更快。
追问
- 怎么量首屏时间?答:在原生层打点(启动到首屏可交互),前端配合 onReady 打点,分段上报。
- 首屏接口太多怎么办?答:合并接口、预取、缓存首屏,把非关键接口延后。
07.2.4.9-002 小程序分包怎么规划?
一句话结论
按"首屏路由"拆分包:主包只放启动页、tab 页、公共资源,非首屏页面放分包;分包间通过路径引用,进入分包页面时才下载,从而控制主包体积与启动时间。
概念解释
小程序有主包体积限制(具体限额以各平台文档为准,待确认),主包含启动页、tab 页、全局组件、公共 JS。非首屏页面(如设置、详情、二级业务)放进分包,用户进入该分包页面时才下载对应分包。
规划原则:一是主包最小化,只留真正首屏需要的;二是按业务模块拆分包,不要一个巨大分包;三是公共资源(如通用组件、工具库)放主包或独立分包;四是图片等大资源走网络或分包内,不塞主包。
原理流程
主包:tab 页 + 启动页 + 公共组件
分包 A:订单模块(pages/order/*)
分包 B:个人中心(pages/user/*)
用户进入订单页 → 下载分包 A → 渲染
代码或图示
| 包 | 内容 | 下载时机 |
|---|---|---|
| 主包 | 启动、tab、公共 | 启动时 |
| 分包 A | 非首屏业务 | 进入对应页面 |
| 分包 B | 低频业务 | 进入对应页面 |
常见误区
- 误区:所有页面都放主包;正解:非首屏页面必须分包,否则主包超限。
- 误区:分包能随便互相引用;正解:分包间引用规则以平台为准,跨分包资源引用有限制。
追问
- 主包超限先查什么?答:主包资源、图片字体、重复依赖、未拆出去的页面。
- 分包预下载怎么做?答:在用户可能跳转的时机预下载分包,具体 API 以平台为准。
07.2.4.9-003 代码与资源体积怎么控制?
一句话结论
代码体积靠压缩、tree-shaking、移除未用依赖;资源体积靠图片压缩、字体子集、大文件走网络;App 端 wgt 体积直接影响热更新与启动,要持续监控。
概念解释
代码体积:构建期压缩(minify)、tree-shaking 移除未用代码、按需引入组件库(不要全量引入 UI 库)、移除 console 与调试代码。资源体积:图片压缩(tinypng、webp)、图标字体子集化、音频视频不打包走网络。
App 端特别注意 wgt 体积:wgt 是前端资源包,越大下载越慢、热更新越慢。定期分析 wgt 里哪些文件占空间,清理未用资源、重复图片、冗余依赖。
原理流程
构建产物分析
→ JS 体积:压缩、tree-shaking、按需引入
→ 图片:压缩、webp、走网络
→ 字体:子集化
→ wgt 体积:定期分析,清理冗余
代码或图示
| 类型 | 优化 |
|---|---|
| JS | 压缩、tree-shaking、按需引入 |
| 图片 | 压缩、webp、CDN |
| 字体 | 子集化 |
| wgt | 定期分析体积 |
常见误区
- 误区:全量引入 UI 库最省事;正解:按需引入能减大量体积。
- 误区:图片打包进包最稳;正解:大图走 CDN,包内只放小图。
追问
- 怎么分析 wgt 体积?答:构建后看产物目录,用分析工具看哪些文件最大。
- 第三方依赖怎么减?答:定期 review package.json,移除未用依赖,替换为更轻的库。
07.2.4.9-004 setData 的成本模型是什么?
一句话结论
小程序/uni-app 里 setData 是逻辑层到视图层的跨桥通信:数据要序列化、跨线程传输、视图层 diff 再渲染;成本 = 数据量 × 频率,频繁传大对象是性能杀手。
概念解释
小程序双线程模型里,逻辑层(JS)与视图层(WebView)是分离的。setData 把 JS 数据序列化为消息,跨线程传到视图层,视图层 diff 后更新 DOM。每次 setData 都有序列化、跨线程、diff 的固定成本。
成本模型:一是单次数据量(大对象、嵌套数组序列化慢);二是频率(一帧内多次 setData 会合并但仍有成本);三是数据字段(只更新变化字段,不要全量 setData)。
更细的量化口径:单次 setData 数据量建议控制在 KB 级,一帧内不要超过 1-2 次;如果单次 setData 传几 MB 的列表数据,光序列化就要几十毫秒,直接挤占帧预算。开发时要养成"只传变化路径"的习惯:this.setData({ 'list[3].name': 'x' }) 而不是 this.setData({ list: wholeList })。
原理流程
逻辑层 setData({ a: 1, list: [...] })
→ 序列化数据
→ 跨线程传输到视图层
→ 视图层 diff
→ 更新 DOM
代码或图示
| 反模式 | 正解 |
|---|---|
| 一帧内多次 setData 大对象 | 合并更新,批量 setData |
| 全量 setData 整个列表 | 只 setData 变化项 |
| setData 里塞非渲染字段 | 渲染字段与逻辑字段分离 |
常见误区
- 误区:setData 是本地赋值;正解:是跨线程通信,有真实成本。
- 误区:数据小就可以频繁 setData;正解:频率本身也有成本,高频输入要节流。
追问
- 输入框实时校验怎么优化?答:节流 setData,只在必要时更新视图,不要每次 keystroke 都 setData。
- 长列表 setData 怎么优化?答:不要全量 setData,只更新可见区域或变化项,配合虚拟列表。
07.2.4.9-005 长列表渲染为什么卡,怎么优化?
一句话结论
长列表卡是因为 DOM 节点过多、每次更新全量 setData、图片加载压力大;优化方向是"只渲染可见项"(虚拟列表/回收列表)、分页加载、图片懒加载与占位。
概念解释
传统做法把几千条数据全部渲染成 DOM,WebView 压力大。优化思路:
- 分页加载:一次只加载一页,滚动到底再加载下一页。
- 虚拟列表:只渲染屏幕可见的十几项,滚动时复用 DOM,不可见项不渲染。
- 图片懒加载:图片进入可视区域才加载,占位图避免布局抖动。
- 减少列表项复杂度:扁平化、避免嵌套、减少嵌套层级。
小程序端有 recycle-view 类组件(具体组件名以官方为准),App 端 nvue 有原生回收列表;传统 uni-app WebView 端用分页 + 虚拟列表。
虚拟列表的核心是"用占位撑开高度 + 只渲染可见项":先按预估高度算出总高度,生成一个等高的占位容器,滚动时根据 scrollTop 计算可视区间,只渲染这区间的项。高度不固定时需要动态测量与缓存。
原理流程
滚动事件
→ 计算可见区域
→ 只渲染可见项 DOM
→ 不可见项回收/移除
→ 图片懒加载
代码或图示
| 方案 | 做法 | 适用 |
|---|---|---|
| 分页加载 | 每次加载一页 | 简单列表 |
| 虚拟列表 | 只渲染可见项 | 长列表 |
| 回收列表 | 原生回收 | nvue/uni-app x |
| 图片懒加载 | 进入可视区才加载 | 图片列表 |
常见误区
- 误区:长列表卡是因为数据多;正解:是 DOM 节点多,不是数据多,虚拟列表能承载上万条。
- 误区:一次加载全部数据最流畅;正解:首屏加载慢,滚动也卡,分页 + 虚拟更好。
追问
- 虚拟列表怎么实现?答:计算可视区域、用占位撑开高度、只渲染可见项,库或自实现。
- 列表项高度不固定怎么办?答:预估高度 + 动态测量,或用固定高度简化。
07.2.4.9-006 nvue 长列表与 WebView 长列表有何差异?
一句话结论
nvue 长列表底层是原生回收视图(类似 RecyclerView),只渲染可见项、滚动流畅;WebView 长列表是 DOM 渲染,节点多时卡;复杂长列表场景用 nvue 是传统 uni-app 的性能手段。
概念解释
nvue 页面渲染到原生视图,列表组件(如 list/recycle-list,具体名以官方为准)底层用原生回收机制:只创建可见的 cell,滑出的复用。这与 WebView 里把所有数据渲染成 DOM 完全不同。
代价是 nvue 样式支持受限(weex 子集)、与 vue 页面混排复杂。所以策略是:普通页面用 vue,长列表/复杂滚动页用 nvue,通过页面跳转衔接。
原理流程
nvue 长列表:
原生 RecyclerView → 只创建可见 cell → 回收复用 → 流畅滚动
WebView 长列表:
DOM 渲染全部数据 → 节点多 → 滚动卡
代码或图示
| 维度 | nvue 列表 | WebView 列表 |
|---|---|---|
| 渲染 | 原生回收 | DOM |
| 千条数据 | 流畅 | 易卡 |
| 样式 | 受限 | 完整 |
| 适用 | 复杂长列表 | 普通页面 |
常见误区
- 误区:所有页面都用 nvue;正解:nvue 样式受限,只在长列表/性能敏感页用。
- 误区:nvue 页面和 vue 页面完全一样;正解:样式、API、组件有差异,要单独调试。
追问
- nvue 页面怎么与 vue 页面跳转?答:用普通路由跳转,互相独立。
- nvue 里能用普通 CSS 吗?答:支持的样式是子集,复杂样式可能不生效,以官方文档为准。
07.2.4.9-007 图片优化有哪些手段?
一句话结论
图片优化从四方面入手:压缩(格式、大小、质量)、懒加载、CDN 与尺寸适配、占位图;列表图用缩略图,详情图用大图,避免一次性加载原图。
概念解释
图片是移动 App 体积与流量的大头。优化手段:
- 格式:用 webp/avif 等压缩格式,比 jpg/png 小。
- 尺寸:按显示尺寸加载,不要 4K 图显示在 100px 位置。
- 懒加载:进入可视区才加载。
- CDN:图片走 CDN,带尺寸参数裁剪。
- 占位图:加载前用灰块/骨架,避免布局抖动。
- 列表缩略图:列表用小图,详情点开大图。
App 端还要注意图片解码内存:大图(如 4000×3000)解码后内存占用大,要压缩显示尺寸。
另外,图片缓存策略也重要:App 端图片缓存在本地,重复图片不要重复下载;列表滚动时要取消未完成的图片请求,避免快速滚动时图片闪烁与流量浪费。
原理流程
图片请求
→ CDN 按尺寸裁剪(?width=100)
→ 懒加载(进入可视区)
→ webp 格式
→ 占位图
→ 显示
代码或图示
| 手段 | 做法 |
|---|---|
| 格式 | webp/avif |
| 尺寸 | 按显示尺寸加载 |
| 懒加载 | 进入可视区 |
| CDN | 裁剪参数 |
| 占位 | 骨架/灰块 |
常见误区
- 误区:图片越大越清晰;正解:按显示尺寸加载,大图浪费流量与内存。
- 误区:所有图片都打包进 App;正解:图片走 CDN,包内只放小图标。
追问
- 列表图怎么省流量?答:用缩略图(小尺寸),详情页再加载大图。
- 大图内存怎么控制?答:压缩解码尺寸,不要原图直接显示在小区域。
07.2.4.9-008 静态资源(字体、音频、视频)怎么处理?
一句话结论
小图标与字体子集打包进包,大音频视频走 CDN 按需加载;字体要子集化只保留用到的字,音频视频不打包避免包体膨胀。
概念解释
静态资源分类:
- 小图标:打包进包(或 iconfont),体积小。
- 字体:如果用 iconfont,子集化只包含用到的图标字形;中文字体太大(几 MB),不能全量打包。
- 音频:提示音小的可打包,背景音乐/语音走 CDN。
- 视频:一律走 CDN,不打包。
App 端 wgt 体积也要控制:这些资源都在 wgt 里,大了热更新慢。
原理流程
小图标 → 打包
iconfont → 子集化打包
音频(大)→ CDN
视频 → CDN
代码或图示
| 资源 | 处理 |
|---|---|
| 小图标 | 打包 |
| iconfont | 子集化 |
| 音频(大) | CDN |
| 视频 | CDN |
| 中文字体 | 不打包 |
常见误区
- 误区:iconfont 全量打包;正解:子集化只留用到的图标。
- 误区:视频打包进包;正解:视频走 CDN,包体会爆。
追问
- 中文字体能不能用?答:web 字体太大,不建议打包;用系统字体或图标字体。
- 资源走 CDN 怎么控缓存?答:文件名带 hash,长缓存 + 版本更新。
07.2.4.9-009 nvue 的使用边界是什么?
一句话结论
nvue 适合长列表、复杂滚动、高性能交互页;不适合样式复杂、Web 特性强、与 vue 页面频繁混排的场景;样式支持是 weex 子集,复杂 CSS 不生效。
概念解释
nvue 是传统 uni-app 里用原生渲染的页面,优势是性能,劣势是能力受限:
- 样式支持:只支持 flex 布局子集,不支持复杂 CSS(伪元素、部分选择器、Web 专有样式)。
- DOM 操作:没有完整 DOM API,不能用 Web 库。
- 混排:nvue 与 vue 页面跳转有成本,组件级混排复杂。
- 调试:与 vue 页面调试方式不同。
适用场景:长列表、信息流、复杂滚动、动画密集页。不适用:营销活动页(样式复杂)、富文本、表单页。
nvue 页面有几个特殊行为要注意:一是 text 组件必须显式用 <text> 包裹,不能像 vue 里直接写文本;二是样式默认 flex-direction: column,与 Web 不同;三是不支持部分 CSS 选择器,样式要扁平化;四是 nvue 里的 JS 逻辑跑在独立线程,与渲染线程通信有成本。
原理流程
页面选型
├─ 长列表/滚动密集 → nvue
├─ 样式复杂/活动页 → vue
└─ 简单页面 → vue
代码或图示
| 场景 | 建议 |
|---|---|
| 长列表/信息流 | nvue |
| 活动页/营销页 | vue |
| 表单页 | vue |
| 复杂动画 | nvue |
常见误区
- 误区:nvue 性能好就全站用 nvue;正解:样式受限,全站 nvue 开发成本高。
- 误区:nvue 里写普通 CSS 都生效;正解:只支持子集,复杂样式不生效。
追问
- nvue 与 uni-app x 的关系?答:nvue 是传统体系的原生渲染,uni-app x 是新体系,见 07.2.4.8。
- nvue 页面怎么调试?答:用 HBuilderX 调试 + 原生工具,样式要真机看。
07.2.4.9-010 WebView 数量与内存怎么管理?
一句话结论
App 端每个 vue 页面都是一个 WebView,页面栈越深 WebView 越多,内存占用越大;要及时关闭不用的页面、避免长链路跳转、监控内存告警。
概念解释
App 端每个 vue 页面都是一个 WebView,页面栈越深 WebView 越多,内存占用越大;要及时关闭不用的页面、避免长链路跳转、监控内存告警。
传统 uni-app App 端是"一个页面一个 WebView"模型:navigateTo 打开新页面就新建一个 WebView,redirectTo 替换、navigateBack 关闭。WebView 是重量级对象,占内存大,页面栈太深(如连续 10 层)会内存飙升,低端机可能崩溃。
管理手段:一是用 redirectTo/switchTab 代替 navigateTo,避免无意义压栈;二是及时关闭中间页(如支付完成后关闭中间页);三是大页面用完即关;四是监控内存告警。
另外要注意:WebView 里加载的图片、JS 堆、DOM 树都会占用内存;低端机 WebView 内存上限低,加载大图或大量 DOM 容易触发 OOM。释放手段是退出页面时及时清理定时器、全局事件、大对象引用。
原理流程
navigateTo → 新建 WebView 压栈
redirectTo → 关闭当前 + 新建
navigateBack → 关闭 WebView 出栈
switchTab → 关闭非 tab 页
代码或图示
| 操作 | 页面栈 |
|---|---|
| navigateTo | +1 层 WebView |
| redirectTo | 替换,不增 |
| navigateBack | -1 层 WebView |
| switchTab | 关闭非 tab 页 |
常见误区
- 误区:连续 navigateTo 十层没事;正解:WebView 内存累积,低端机崩。
- 误区:navigateBack 后 WebView 自动回收;正解:要等系统回收,及时关闭中间页。
追问
- 页面栈深度限制?答:平台有上限(通常 10 层),超限 navigateTo 失败。
- 怎么减少 WebView 占用?答:路由设计上少用 navigateTo,多用 redirectTo/switchTab,及时关闭。
07.2.4.9-011 App 启动怎么优化?
一句话结论
启动优化从"减少 onLaunch 同步任务、延迟非关键 SDK、配置 splash 屏、减少首屏资源"四方面入手,目标是让用户尽快看到可交互内容。
概念解释
启动慢的原因:一是 App.onLaunch 里做了太多同步初始化(SDK、网络、本地存储);二是 WebView 初始化慢;三是首屏资源大。优化:
- onLaunch 里只做必要初始化,非关键 SDK 延迟到首屏后。
- 网络请求不要阻塞启动,异步并行。
- splash 屏配置,避免白屏。
- 首屏资源压缩、分包。
- 启动打点,分段量。
原理流程
App.onLaunch
→ 必要初始化(同步,快)
→ 非关键 SDK(延迟/异步)
→ 首屏数据(预取/缓存)
→ splash 屏
→ 首屏渲染
代码或图示
| 优化点 | 做法 |
|---|---|
| onLaunch | 减少同步任务 |
| SDK | 延迟初始化 |
| splash | 配置避免白屏 |
| 资源 | 压缩分包 |
常见误区
- 误区:onLaunch 里初始化所有 SDK;正解:非关键 SDK 延迟到首屏后。
- 误区:启动慢就是代码问题;正解:WebView 初始化、首屏资源都要算。
追问
- 怎么量启动时间?答:原生层打点(App 启动到首屏可交互),前端 onLaunch/onReady 配合。
- splash 屏怎么配?答:在 manifest 里配置启动屏图片与样式,具体以官方文档为准。
07.2.4.9-012 splash 屏与白屏怎么处理?
一句话结论
splash 屏是 App 启动时的原生占位图,避免白屏;白屏是 WebView 加载前的空白,通过配置 splash、减少首屏加载、预渲染来缓解。
概念解释
App 启动时原生壳先显示 splash 屏(一张图),然后 WebView 加载前端资源。如果 splash 配置不当或 WebView 加载慢,用户会看到白屏。处理:
- 配置 splash 屏图片,与首屏风格一致。
- splash 显示时长控制,不要太长。
- 首屏资源预加载、分包。
- 首屏用骨架屏/占位,减少感知白屏。
iOS 与 Android 的 splash 机制不同,要分别配置。
原理流程
App 启动
→ 原生 splash 屏显示
→ WebView 加载前端资源
→ 首屏渲染
→ splash 关闭
代码或图示
| 问题 | 处理 |
|---|---|
| 白屏 | 配置 splash 屏 |
| splash 太长 | 优化首屏加载 |
| 首屏跳变 | 骨架屏与首屏一致 |
常见误区
- 误区:splash 屏是前端页面;正解:splash 是原生壳的占位图,在 manifest 配置。
- 误区:白屏无解;正解:通过 splash 配置 + 首屏优化可大幅缓解。
追问
- splash 屏配置在哪?答:manifest.json 的 App 配置里,具体字段以官方文档为准。
- 怎么测白屏?答:真机冷启动录屏,看从点图标到首屏内容的时间。
07.2.4.9-013 线上白屏怎么监控与排查?
一句话结论
白屏监控靠前端错误上报 + 页面加载时长打点 + 原生崩溃日志;排查时先区分是原生崩溃、WebView 加载失败、JS 报错、还是 wgt 问题,分层定位。
概念解释
线上白屏是多因的:
- 原生崩溃:App 闪退,不是白屏。
- WebView 加载失败:资源下载失败、wgt 损坏。
- JS 报错:首屏脚本异常导致页面不渲染。
- 网络问题:接口挂了但页面框架在。
- 兼容性:某机型/WebView 版本不支持。
监控:前端错误上报(JS error、unhandledrejection)、页面加载时长、白屏检测(首屏元素是否渲染)、原生崩溃平台。
原理流程
白屏反馈
→ 看原生崩溃日志
→ 看前端错误上报
→ 看页面加载时长
→ 看 wgt 版本与下载日志
→ 分机型/版本
代码或图示
| 层 | 检查 |
|---|---|
| 原生 | 崩溃日志 |
| WebView | 资源加载日志 |
| JS | 错误上报 |
| 网络 | 接口成功率 |
| wgt | 版本分布 |
常见误区
- 误区:白屏就是 JS 报错;正解:可能是 wgt 损坏、资源加载失败、兼容性。
- 误区:白屏监控靠用户反馈;正解:要主动埋点上报。
追问
- 怎么检测白屏?答:首屏渲染后检测关键元素是否存在,超时上报。
- 白屏怎么兜底?答:远程配置降级、wgt 回滚、提示重试。
07.2.4.9-014 兼容性问题怎么处理?
一句话结论
兼容性问题按"机型/系统版本/WebView 版本/小程序平台"分层,建立兼容性矩阵,用条件编译与降级策略处理,不追求所有端像素级一致。
概念解释
uni-app 跨端开发,兼容性来源:
- 系统版本:Android/iOS 版本差异。
- WebView 内核:不同厂商 WebView 版本不同。
- 小程序平台:微信/支付宝/抖音/百度差异。
- 机型:低端机性能、特定厂商定制。
处理:建立兼容性矩阵,在主流机型/版本上测试;用条件编译处理差异;不支持的能力做降级;线上监控兼容性错误率。
原理流程
兼容性问题
→ 定位:机型/系统/平台/版本
→ 条件编译适配
→ 不支持的能力降级
→ 线上监控
代码或图示
| 维度 | 处理 |
|---|---|
| 系统版本 | 条件编译 |
| WebView 内核 | 兼容性检测 |
| 小程序平台 | 条件编译 |
| 机型 | 真机测试 |
常见误区
- 误区:H5 调试通过就全端通过;正解:小程序/App 必须真机回归。
- 误区:兼容性问题靠猜;正解:要建矩阵、测主流、线上监控。
追问
- 怎么测兼容性?答:主流机型/系统版本真机矩阵,覆盖低端机。
- 新 API 不支持怎么办?答:能力检测 + 降级,不要直接调用。
07.2.4.9-015 典型踩坑清单有哪些?
一句话结论
高频踩坑集中在:rpx 与 px 混用、条件编译位置错、生命周期理解错位、setData 频繁、样式各端不一致、本地存储容量、页面栈过深、nvue 样式不生效。
概念解释
汇总高频坑:
- 样式:rpx 换算错误、各端 CSS 支持差异、nvue 样式受限。
- 条件编译:写在运行时判断(应该编译期)、位置不当。
- 生命周期:onShow/onHide 时机误解、组件销毁未清定时器。
- 数据:频繁 setData 大对象、本地存储容量超限。
- 路由:navigateTo 栈过深、tab 页用错 API。
- 打包:manifest 配置漏、证书错误。
再补充几类隐蔽坑:一是事件冒泡,小程序里 bindtap 与 catchtap 的区别,误用 catch 导致事件穿透;二是本地存储同步 API 阻塞主线程,大量数据用 uni.setStorageSync 会卡;三是全局状态在多页面间不同步,改了 store 但页面没刷新;四是条件编译在样式里写位置错,导致样式没生效;五是小程序里 setData 传函数或循环引用会报错。
原理流程
踩坑清单:
样式(rpx/CSS 差异)
条件编译(位置/时机)
生命周期(时机/清理)
setData(频率/数据量)
路由(栈深/API)
打包(配置/证书)
代码或图示
| 类别 | 典型坑 |
|---|---|
| 样式 | rpx 混用、CSS 差异 |
| 条件编译 | 运行时判断 |
| 生命周期 | 定时器未清 |
| 数据 | setData 频繁 |
| 路由 | 栈过深 |
| 打包 | 配置漏 |
常见误区
- 误区:开发期跑通就完事;正解:多端真机回归是必须的。
- 误区:条件编译是运行时 if;正解:是编译期裁剪。
追问
- 怎么避免踩坑?答:建立 checklist,每次发版前过一遍多端适配。
- 哪个坑最高频?答:样式各端不一致与 setData 性能问题。
07.2.4.9-016 综合题:用户反馈"列表页卡顿,低端机尤其明显",你怎么排查?
一句话结论
按"数据量 → DOM 节点数 → setData 频率 → 图片加载 → 机型性能"分层排查:先量帧率与节点数,再看是否全量渲染、setData 频率、图片压力,最后决定分页/虚拟列表/图片优化/nvue。
概念解释
排查顺序:
- 确认场景:多少条数据、列表项复杂度、图片数量、机型。
- 量帧率:低端机上滚动帧率是多少。
- 看 DOM 节点数:是否一次渲染全部数据。
- 看 setData:滚动时是否频繁 setData 大对象。
- 看图片:是否一次性加载所有图、是否原图。
- 决策:
- DOM 节点多 → 分页 + 虚拟列表。
- setData 频繁 → 合并更新、只更新可见项。
- 图片压力 → 懒加载 + 缩略图 + 占位。
- 复杂度高 → 改 nvue。
- 低端机仍卡 → 降级(减少动画、骨架屏)。
原理流程
卡顿反馈
→ 量帧率/节点数
→ DOM 全量? → 分页/虚拟列表
→ setData 频繁? → 合并/局部更新
→ 图片压力? → 懒加载/缩略图
→ 复杂度高? → nvue
→ 低端机仍卡? → 降级策略
代码或图示
判定树:
卡顿 → 数据量多大?
├─ 几百条 → 看 setData 频率
├─ 几千条 → 分页 + 虚拟列表
└─ 图片多 → 懒加载 + 缩略图
└─ 仍卡 → nvue 或降级
常见误区
- 误区:卡顿就是手机性能差;正解:先看自己实现是否全量渲染、setData 频繁。
- 误区:上虚拟列表就万事大吉;正解:图片、列表项复杂度仍要优化。
追问
- 怎么量滚动帧率?答:真机录屏 + Profiler,或前端埋点上报帧率。
- 虚拟列表还是 nvue 怎么选?答:WebView 端先虚拟列表,仍卡或样式简单再 nvue。