结论先行:小程序启动慢的原因基本落在三段——代码包下载、首屏数据等待、首屏渲染。对应的解法也明确:用分包加载把主包压到最小、用分包预加载提前拉取后续页面代码;首屏请求合并、并行加缓存;setData 只做差量更新并控制频率与数据量。三件事都做完,多数商城与工具类小程序的启动耗时能有肉眼可见的下降。具体配置字段以微信官方最新文档为准。
一、先搞清楚启动耗时花在哪
小程序冷启动大致经历:下载代码包(或读缓存)、注入执行 app.js 与页面 js、页面 onLoad 发起请求、拿到数据 setData、渲染首屏。开发者常犯的错误是只盯着最后一段,而实际上:
- 主包体积越大,首次下载越慢,弱网下尤其明显;
- onLoad 里串行发三四个请求,总等待时间是各请求之和;
- 一次性 setData 整个列表对象,逻辑层到视图层的通信与 diff 成本都会放大。
排查建议先用开发者工具的体验评分与真机调试的性能面板,看启动各阶段耗时分布,再决定优化优先级,不要凭感觉乱改。
二、分包加载:主包只留首屏必需
微信官方分包机制的规则要点:主包放启动即用的页面与公共资源,分包按业务模块拆分;整个小程序所有分包有总大小上限,单个分包与主包也有各自上限(具体数值以官方文档为准)。tabBar 页面必须放在主包。
拆分原则按「访问路径」而不是按「文件类型」:
| 模块 | 建议位置 | 理由 |
|---|---|---|
| 首页、分类、购物车、我的 | 主包 | tabBar 页面,启动即达 |
| 商品详情、搜索 | 主包或高频分包 | 转化主链路,跳转频繁 |
| 订单、售后、地址管理 | 分包 order | 低频但成体系 |
| 营销活动页(拼团、砍价专题) | 分包 activity | 活动期才访问 |
| 设置、关于、协议页 | 分包 misc | 极低频 |
配置示意(JS 对象形式,实际写入 app.json 按 JSON 规范):
{
pages: ['pages/index/index', 'pages/cart/cart'],
subpackages: [
{ root: 'pkgOrder', pages: ['list/list', 'detail/detail'] },
{ root: 'pkgActivity', pages: ['groupon/groupon'] }
]
}两个高频坑:一是分包之间不能互相引用对方的私有资源,公共组件与工具函数要放主包或公共目录;二是分包异步化能力允许跨分包引用组件与 js,但有基础库版本要求,用之前查兼容表。
三、分包预加载与独立分包
分包预加载让框架在进入某个页面后,利用空闲时间提前下载可能用到的分包,用户真正跳转时几乎无等待。配置 preloadRule:
{
preloadRule: {
'pages/index/index': {
network: 'all',
packages: ['pkgOrder']
},
'pages/detail/detail': {
network: 'wifi',
packages: ['pkgActivity']
}
}
}network 取 all 或 wifi:营销类分包建议 wifi 下预载,避免消耗用户流量;订单这类大概率会去的分包可以 all。预加载有体积配额限制,别把所有分包都塞进一条规则。
独立分包(independent: true)则不依赖主包即可运行,适合广告投放落地页、活动页这类「用户直奔某个页面」的场景,能跳过主包下载直接启动。代价是独立分包内不能依赖主包的公共代码与 getApp 的初始化结果,登录态、全局配置都要在分包内自行处理,适合页面少、逻辑独立的场景,不要滥用。
四、首屏数据:合并、并行、缓存
代码包之外,首屏等待通常是请求问题。可操作的四个动作:
- 并行化:首页 Banner、公告、推荐商品互不依赖,用 Promise.all 并行拉取,而不是 await 串成一条链。
- 接口聚合:如果后端可控,把首屏多个接口合成一个聚合接口,一次往返拿全数据。
- 本地缓存兜底:分类、Banner 这类低频变化数据写入 storage 并设过期时间,启动先渲染缓存再静默刷新,用户感知是「秒开」。
- 骨架屏:数据未返回时先渲染骨架占位,避免白屏;缓存加骨架屏组合是商城首页的标配。
后端选型也影响首屏。自建后端要自己设计聚合接口与缓存策略;用「api工厂」(https://www.it120.cc/)这类现成开放平台,CMS 的 Banner、公告、文章与商品推荐都有标准接口,apifm-wxapi SDK 里 WXAPI.init('subDomain') 之后按模块调用即可,统一返回 code、data、msg,code 为 0 即成功,前端做并行与缓存封装非常顺手:
const [banners, goods] = await Promise.all([
WXAPI.banners({ key: 'index' }),
WXAPI.goods({ recommendStatus: 1, pageSize: 10 })
]);
if (banners.code === 0 && goods.code === 0) {
this.setData({ banners: banners.data, goods: goods.data.result });
}接口清单与参数见帮助中心(https://www.it120.cc/help/index.html),首屏只取需要的字段与条数,别把整个商品库拉到首页。
五、setData 治理:渲染段的最大变量
setData 的成本在于数据要从逻辑层序列化传到视图层,再做 diff 与重渲染。治理规则:
- 只传变化字段:更新列表第 3 项用路径写法 setData({ 'list[2].stock': 5 }),不要整包重传 list。
- 合并调用:一个事件循环里的多次 setData 合并成一次;分页加载先 concat 再一次性 setData,严禁循环里逐条 set。
- 控制单次体积:单次数据尽量控制在几十 KB 量级,长列表配合 recycle-view 或分页截断,不要把上千条数据全塞进 data。
- 与渲染无关的数据不放 data:接口原始报文、定时器句柄、临时标记挂在 this 上即可,放 data 只会白白增加 diff 成本。
- 避免后台页面 setData:页面 onHide 后暂停轮询与更新,回到前台再刷新。
六、启动优化排查清单
- 主包是否只含 tabBar 与主链路页面,公共依赖是否被误打进分包;
- preloadRule 是否覆盖主要跳转路径,network 策略是否合理;
- 首屏请求是否并行或有聚合接口,是否有缓存兜底与骨架屏;
- setData 是否差量、合并、限量,data 里是否混入无关数据;
- 用体验评分与真机性能面板复测,记录优化前后启动耗时对比。
性能优化没有银弹,按「下载、等待、渲染」三段定位瓶颈,逐项落地即可。配置细节与体积上限请以微信官方最新文档为准。