罗罗编程学习记录
本页内容 展开查看

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。

概念解释

排查顺序:

  1. 确认场景:多少条数据、列表项复杂度、图片数量、机型。
  2. 量帧率:低端机上滚动帧率是多少。
  3. 看 DOM 节点数:是否一次渲染全部数据。
  4. 看 setData:滚动时是否频繁 setData 大对象。
  5. 看图片:是否一次性加载所有图、是否原图。
  6. 决策:
    • DOM 节点多 → 分页 + 虚拟列表。
    • setData 频繁 → 合并更新、只更新可见项。
    • 图片压力 → 懒加载 + 缩略图 + 占位。
    • 复杂度高 → 改 nvue。
    • 低端机仍卡 → 降级(减少动画、骨架屏)。

原理流程

卡顿反馈
  → 量帧率/节点数
  → DOM 全量? → 分页/虚拟列表
  → setData 频繁? → 合并/局部更新
  → 图片压力? → 懒加载/缩略图
  → 复杂度高? → nvue
  → 低端机仍卡? → 降级策略

代码或图示

判定树:
卡顿 → 数据量多大?
  ├─ 几百条 → 看 setData 频率
  ├─ 几千条 → 分页 + 虚拟列表
  └─ 图片多 → 懒加载 + 缩略图
  └─ 仍卡 → nvue 或降级

常见误区

  • 误区:卡顿就是手机性能差;正解:先看自己实现是否全量渲染、setData 频繁。
  • 误区:上虚拟列表就万事大吉;正解:图片、列表项复杂度仍要优化。

追问

  • 怎么量滚动帧率?答:真机录屏 + Profiler,或前端埋点上报帧率。
  • 虚拟列表还是 nvue 怎么选?答:WebView 端先虚拟列表,仍卡或样式简单再 nvue。