抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • 开发教程与代码示例
  • 入门
  • 小程序框架
  • 小程序运行时
  • 自定义组件
  • 基础教程
  • 能力教程
  • 性能优化
  • 概述
  • 小程序白屏&渲染异常问题优化
  • 启动性能
  • 运行时性能
  • 性能优化方法
  • 性能优化辅助平台/工具
  • 性能指标获取方式
  • 线上分析平台
  • 线下调试工具
  • 体验评分
  • 体验评分简介
  • 评分方法
  • 评分规则
  • 体验
  • 质量
  • 最佳实践
  • 性能 Trace 工具
  • 客户端性能分析工具
  • 安全
  • 弹窗异常率

    通过标准:任意 2 秒内无连续弹窗行为(两次弹窗间隔≥1 秒),高频率弹窗视为异常。频繁弹窗会降低交互流畅性。
    连续弹窗:弹窗间隔小于 1s。

    小程序包大小检测

    通过标准:未配置分包的情况下,小程序包源码大小不超过 4M
    包过大会影响小程序启动耗时,建议开发者删除无用图片资源及冗余代码,并使用小程序分包进行包大小优化,可参考减少小程序包体积方案。

    FP

    通过标准:80 分以上视为通过该项检测
    FP(First Paint 即小程序启动到首屏渲染耗时)。该指标从启动开始计算,直至完成首屏 DOM 树构建,数值过高将导致用户长时间面对白屏界面。优化 FP,可参考小程序的启动性能优化。

    LCP

    通过标准:80 分以上视为通过该项检测
    LCP(Largest Contentful Paint 从打开小程序到首次看到页面中最大内容的耗时)。优化 LCP 可以分为以下几种情况:
    首屏渲染内容较多时,开发者应优先处理关键数据的分层加载机制,通过内容优先级排序缩短白屏时间;
    首屏内容依赖的数据从服务端请求的时间太长。开发者需要从服务端具体分析数据返回时间长的原因;
    一次性渲染数据太大或依赖的计算过于复杂。减少渲染的数据量、优化渲染相关数据的算法可以解决这类问题。

    FID

    通过标准:不超过 100ms
    FID(First Input Delay 指首次交互到响应交互事件的时间间隔)。较长的延迟会导致明显的卡顿体验。我们建议将 FID 尽量控制在 100ms 以内,以快速响应用户操作。请检查启动过程中的脚本执行时间是否过长。

    CLS

    通过标准:不超过 0.1
    CLS(Cumulative Layout Shift 累积布局偏移)。测量的是整个页面生命周期内发生的所有单次布局偏移分数的总和。应将 CLS 分数控制在 0.1 或以下,若分数过高,建议为页面元素预留所需的空间。除非是对用户交互做出响应,否则切勿在现有内容的上方插入内容。首选转换动画,而不是触发布局偏移(元素位置变更)的属性动画。

    脚本执行时间检测

    通过标准:一个执行周期内脚本运行时间不超过 1 秒
    脚本执行时间是指 JS 脚本在一次同步执行中消耗的时间,比如生命周期回调(onLoad)、事件处理函数的同步执行时间。执行脚本的耗时过长让用户觉得卡顿,体验较差,出现这一情况时,需要确认并优化脚本的逻辑,可参考减少同步逻辑建议。

    setData 调用频率

    通过标准:每秒调用 setData 的次数不超过 20 次
    setData 接口的调用涉及逻辑层与渲染层间的线程通信,通信过于频繁可能导致处理队列阻塞,界面渲染不及时而导致卡顿,应避免无用的频繁调用。可参考合理使用 setData。

    setData 数据大小

    通过标准:JSON.stringify 后不超过 256KB
    由于小程序运行在逻辑线程与渲染线程之上,setData 的调用会把数据从逻辑层传到渲染层,数据太大会增加通信时间。

    渲染耗时

    通过标准:渲染耗时不超过 300ms
    渲染耗时指的是首次渲染或因数据变化带来的页面结构变化的渲染花费的时间。渲染界面的耗时过长会让用户觉得卡顿,体验较差,出现这一情况时,需要校验是否同时渲染的区域太大(例如列表过长),或渲染依赖的计算是否过于复杂。

    网络请求耗时

    通过标准:所有网络请求都在 500ms 内返回结果
    请求的耗时太长会让用户一直等待甚至离开,应优化服务器处理时间、减小回包大小,让请求快速响应。

    网络请求频率

    通过标准:每秒通过 tt.request 发起的耗时超过 300ms 的请求并发数不超过 10 个
    过多请求会触发并行请求数量限制,同时也可能导致加载慢等问题,应合理控制请求数量,甚至做请求的合并等。

    网络请求缓存

    通过标准:3 分钟内同一个 URL 请求不应出现两次回包内容相同且大小超过 128KB 的情况
    发起网络请求总会让用户等待,可能造成不好的体验,应尽量避免多余的请求,比如对同样的请求进行缓存。

    网络请求 URL 长度检测

    通过标准:网络请求的 URL 长度不应超过 2048 个字符
    小程序网络请求的链路:tt.request -> 网络库 -> 外部网络环境(WiFi、3G、4G)-> 服务端。URL 过长会导致以下两种情况:
      1.小程序发送给服务端的数据包过大,会延长数据传输时长和处理时长,最终影响小程序启动耗时;
      2.可能导致网络请求失败
    我们建议如非必要减少 URL 长度。

    TTML 节点数

    通过标准:页面 TTML 节点少于 1000 个,节点树深度少于 30 层,最大子节点数不大于 60 个
    建议一个页面使用少于 1000 个 TTML 节点,节点树深度少于 30 层,最大子节点数不大于 60 个。一个太大的 TTML 节点树会增加内存的使用,样式重排时间也会更长,影响体验。

    图片请求数

    通过标准:每秒发起的图片请求数不超过 20 个
    短时间内发起太多图片请求会触发浏览器并行加载的限制,可能导致图片加载慢,用户一直处于等待。应该合理控制数量,可考虑使用雪碧图技术或在屏幕外的图片使用懒加载。

    图片缓存

    通过标准:所有图片均开启 HTTP 缓存
    开启 HTTP 缓存控制后,下一次加载同样的图片,会直接从缓存读取,大大提升加载速度。

    图片大小检测

    通过标准:包内单张不超过 100KB;网络单张不超过 300KB
    包内图片:代码包内的图片大小会影响包的整包大小,进而影响整体启动耗时;
    网络图片:图片较大会影响小程序页面渲染耗时,容易出现阶段性白屏。
    请参考图片优化建议。

    图片缩放检测

    通过标准:使用合适尺寸的图片
    图片若没有按原图宽高比例显示,可能导致图片扭曲变形,影响视觉效果和内容识别。建议开发者根据实际情况设置 image 组件的 mode 属性,以保持原图宽高比例显示。
    说明
    图片相关的检测项针对的是 image 组件。
    ​