uni-app 无开箱即用性能面板,但可通过 uni.onPageLoad 与 uni.onPageRender 打点计算首屏渲染耗时,结合 platform、SDKVersion、network.type 做跨端降级策略,并慎用 onMemoryWarning 仅作兜底清理,h5.performance.enable 仅对 H5 生效且需手动清理标记。

uni-app 没有内置的「开箱即用」页面性能监控面板,但可通过组合标准 API + 时间戳打点 + 条件逻辑,实现跨端一致、轻量可控的页面级性能采集。关键不在于堆工具,而在于找准打点时机和可比指标。
怎么用 uni.onPageLoad 和 uni.onPageRender 打首屏耗时
这两个生命周期钩子是页面性能基线的核心依据,它们在 H5、App、小程序中均可用,且触发时机稳定:
-
uni.onPageLoad触发于页面参数解析完成、data初始化后,代表「逻辑准备就绪」 -
uni.onPageRender触发于视图首次渲染完成(非 DOM ready,而是框架层确认内容已上屏),代表「用户可见起点」 - 两者时间差 ≈ 首屏渲染耗时,比单纯用
onReady更贴近真实体验 - 注意:不能在
onLoad里直接调用performance.now()算差值,因为onPageRender是全局监听,需提前存时间戳
示例代码:
// main.js 或 App.vue 的 onLaunch 中
const startTime = performance.now()
uni.onPageLoad(page => {
page.loadTime = performance.now() - startTime
})
uni.onPageRender(page => {
page.renderTime = performance.now() - startTime
console.log(`页面 ${page.route} 首屏渲染耗时: ${Math.round(page.renderTime)}ms`)
})
为什么 uni.getSystemInfoSync().platform 要配合性能策略
不同平台的渲染机制差异极大:H5 依赖 WebView 性能,微信小程序有双线程限制,App 端则受原生容器影响。只看毫秒数没意义,必须结合设备能力做降级判断:
- Android 5.x / iOS 10 等旧系统,
scroll-view滚动卡顿率高,应默认关闭下拉刷新动画 -
uni.getSystemInfoSync().SDKVersionvirtual-list 组件可能不兼容,需 fallback 到分页加载 - H5 环境下若检测到
navigator.connection.effectiveType为'2g'或'3g',应延迟加载非关键图片、禁用自动播放视频
这类判断不能写死在页面里,建议封装成 usePerformanceGuard() Hook,在页面 setup 中统一调用。
如何避免 uni.onMemoryWarning 被当成内存监控主力
uni.onMemoryWarning 是个被动通知,只在系统内存严重不足时触发(如 Android Low Memory Killer 启动前),它不是实时内存读数,也不能告诉你当前用了多少 MB:
- 它不返回任何数值,只抛事件,无法量化分析
- iOS 上该事件极少触发,基本不可靠
- 误把它当「内存监控 API」会导致误判——比如页面没崩溃,但你已经收到 3 次警告,其实只是后台 App 在抢占资源
- 真正该关注的是它的上下游信号:
onPageHide后是否伴随长时间未onPageShow,或onMemoryWarning触发后紧接着onUnload,这才是内存压力的真实链路
所以,别用它画内存曲线,只用它做兜底清理:释放缓存图片、暂停定时器、取消未完成请求。
manifest.json 里的 h5.performance.enable 有什么实际作用
开启这个配置后,uni-app 会在 H5 端自动注入 performance.mark() 和 performance.measure(),生成基础时间标记,但仅限 H5:
- 它会记录
app:start、page:load、page:render等标记,可通过performance.getEntriesByType('measure')读取 - 对小程序、App 端完全无效,不要指望它跨端统一
- 开启后会轻微增加 JS 执行开销(微秒级),云打包时默认关闭,本地调试可开
- 如果你自己打了更细粒度的点(比如接口请求开始/结束),记得用
performance.clearMarks()避免污染
配置位置:manifest.json → h5 → performance → enable: true,无需额外 JS 调用。
最易被忽略的一点:性能监控数据本身会消耗性能。打点太密、上报太勤、计算太重,反而拖慢页面。建议只保留下述三类必采点——首屏渲染时间、关键交互响应延迟(如按钮点击到弹窗出现)、错误发生前 5 秒内的内存与 FPS 快照。其余全砍。



















