今年八月,一个做家居零售的客户急着上线,代码写完、审核资料也备齐了,上传那一步直接被拦下来:「代码包大小超过限制」。主包 2.34MB,超了 340KB,一行业务代码都还没跑起来。
这种事在门店类小程序里特别常见:功能是一年年加上去的,商品详情、活动页、会员卡、门店导航、客服,每加一个都往主包里塞,等到提审才发现包体早就越线。这篇记录一次真实的瘦身过程——从 2.34MB 到 1.08MB,四个动作、三个坑,以及做完之后怎么防止再胖回去。
先说结论:主包超标九成不是「业务太多」,而是三件事没做——图片没出包、分包没切、依赖没查。这三件事做完,一般能砍掉 40%~55%,而且不影响任何功能。
一、先拆开看:2.34MB 到底被谁吃掉了
不要一上来就删代码。先在小程序开发者工具里点「详情 → 本地代码 → 代码依赖分析」,把体积按类型拆开,再决定动哪里。我们这次的结构是这样的:
| 构成 | 瘦身前 | 占比 | 问题所在 |
|---|---|---|---|
| 图片与图标 | 1.02MB | 44% | Banner、商品占位图、分享图全在本地 images/ |
| 第三方 SDK 与 npm 包 | 610KB | 26% | UI 库整包引入,图表库只用到一个图 |
| 业务代码(js/wxml/wxss) | 480KB | 21% | 三个已下线的活动页还留在包里 |
| 字体与其他资源 | 230KB | 9% | 两个 ttf 字体,实际只用到 20 多个字 |
这张表一出来,方向就清楚了:真正需要「重构」的业务代码只占两成,剩下八成都是资源摆放和依赖引入的问题。先解决这八成,往往不用碰一行业务逻辑。
二、四个动作,按性价比排序
动作一:删——先清死代码和重复依赖
用开发者工具的「代码依赖分析」配合「无引用文件」筛选,把没人引用的页面、组件、图片列出来。我们这次清出三个下线活动的页面(约 190KB)、一套重复引入的图标库(约 80KB),还有 60 多张产品图的历史版本。删除前确认三件事:路由配置里是否还挂着、有没有通过 require 动态引用、有没有被分享路径直接打开。这三项确认完,删起来没有风险。
动作二:移——图片和字体从主包里搬出去
这是单次收益最大的一步。Banner、商品图、分享图本来就不需要随包下载,全部改走 CDN 或对象存储,代码里只留 URL。图标统一换成 iconfont 或内联 SVG,一套雪碧图能顶掉几十张 png。
字体要特别注意:中文字体动辄 3~5MB,除非整站都用,否则别放本地。我们这次把两个 ttf 换成 CDN 上的字体子集,只保留用到的 26 个字,230KB 直接归零。
动作三:分——分包,主包只留首页和 tabBar
微信规定 tabBar 页面必须留在主包,所以主包的底线是「首页 + 其余 tab 页 + 公共组件」。把商品详情、活动、会员中心、订单这些按业务域切成独立分包,用户点进去才下载。配置本身只有几行:
"subPackages": [
{ "root": "packages/goods", "pages": ["detail/index", "search/index"] },
{ "root": "packages/member", "pages": ["center/index", "card/index"] },
{ "root": "packages/order", "pages": ["list/index", "detail/index"] }
],
"preloadRule": {
"pages/index/index": { "network": "all", "packages": ["packages/goods"] }
}
preloadRule 是关键:不预载的话,首次进分包会有半秒白屏,体验反而变差。把最可能被点的分包挂在首页预载,实际感知和没分包差不多。
动作四:换——大 SDK 换轻量实现
UI 库整包引入是最常见的浪费。我们原来引了一整套组件库,实际只用到 7 个组件,改成按需引入后从 310KB 降到 62KB。另外有个图表库只用来画一条销售趋势折线,换成 canvas 手写 80 行,体积从 190KB 变成 0。
判断标准很简单:一个依赖如果只服务于一个页面、一种图表、一次分享,那它就不该躺在主包里。功能不变、体积砍掉,这才是最划算的优化。
三、分包时会踩的三个坑
- 公共代码被重复打包。主包和分包都引用了同一个 utils,默认会在两边各打一份。把这类代码提到主包,并在
app.json里开启"optimization": {"subPackages": true},让工具自动把公共依赖抽出来,一次能省几十 KB。 - 分包路径写错导致 404。分包内的跳转必须用完整路径
/packages/goods/detail/index,别用相对路径。root后面不要带斜杠,pages里也不要再重复 root。 - 分包做完主包还是超。说明 tabBar 页面里还压着大图或大 SDK。把 tab 页的图片改成网络图,非首屏模块拆成异步组件,通常还能再挤出 100~200KB。
四、结果:体积和启动一起下来了
| 指标 | 瘦身前 | 瘦身后 | 变化 |
|---|---|---|---|
| 主包体积 | 2.34MB | 1.08MB | -54% |
| 分包数量 | 0 | 3 | 按业务域切分 |
| 首次启动(4G 冷启) | 2.8s | 1.4s | -50% |
| 首页可交互时间 | 3.2s | 1.6s | -50% |
| 功能与埋点 | — | 全部保留 | 无删减 |
提审一次通过。比体积更实际的变化在用户侧:客户后台的首页跳出率降了十几个点——原来不少用户就是在白屏那两秒里退出的。
五、别让它再胖回去
瘦身不是一次性动作。三个月不设卡,包体一定回到 2MB 附近。建议把这四条固化成上线前的检查项:
- 主包体积超 1.5MB 就在群里报警,别等到提审被拒。
- 新图片一律走 CDN,本地只留 tabBar 图标和启动图。
- 引入新依赖前先看体积,超过 100KB 的必须说明理由。
- 新功能默认开分包,主包只允许放 tab 页和公共组件。
一分钟自查:打开开发者工具的依赖分析,看「图片」和「第三方库」两项占比加起来有没有超过 40%。超了,就还有 300KB 以上的空间可以腾,而且不用改任何业务逻辑。
写在最后
包体积这件事,本质是把「谁该随包走、谁该用的时候再拿」想清楚。想清楚之后,功能一个没少、代码没怎么删,包就瘦下来了,启动也快了。如果你们的小程序正卡在提审,或者首页慢得让人着急,可以拨 18833330416 或在网站留言,我们先把依赖和资源盘一遍,再判断该瘦身还是该重构。
