主包 2.34MB 传不上去:一个门店小程序的四步瘦身实战

今年八月,一个做家居零售的客户急着上线,代码写完、审核资料也备齐了,上传那一步直接被拦下来:「代码包大小超过限制」。主包 2.34MB,超了 340KB,一行业务代码都还没跑起来。

这种事在门店类小程序里特别常见:功能是一年年加上去的,商品详情、活动页、会员卡、门店导航、客服,每加一个都往主包里塞,等到提审才发现包体早就越线。这篇记录一次真实的瘦身过程——从 2.34MB 到 1.08MB,四个动作、三个坑,以及做完之后怎么防止再胖回去。

先说结论:主包超标九成不是「业务太多」,而是三件事没做——图片没出包、分包没切、依赖没查。这三件事做完,一般能砍掉 40%~55%,而且不影响任何功能。

一、先拆开看:2.34MB 到底被谁吃掉了

不要一上来就删代码。先在小程序开发者工具里点「详情 → 本地代码 → 代码依赖分析」,把体积按类型拆开,再决定动哪里。我们这次的结构是这样的:

构成瘦身前占比问题所在
图片与图标1.02MB44%Banner、商品占位图、分享图全在本地 images/
第三方 SDK 与 npm 包610KB26%UI 库整包引入,图表库只用到一个图
业务代码(js/wxml/wxss)480KB21%三个已下线的活动页还留在包里
字体与其他资源230KB9%两个 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。

判断标准很简单:一个依赖如果只服务于一个页面、一种图表、一次分享,那它就不该躺在主包里。功能不变、体积砍掉,这才是最划算的优化。

三、分包时会踩的三个坑

  1. 公共代码被重复打包。主包和分包都引用了同一个 utils,默认会在两边各打一份。把这类代码提到主包,并在 app.json 里开启 "optimization": {"subPackages": true},让工具自动把公共依赖抽出来,一次能省几十 KB。
  2. 分包路径写错导致 404。分包内的跳转必须用完整路径 /packages/goods/detail/index,别用相对路径。root 后面不要带斜杠,pages 里也不要再重复 root。
  3. 分包做完主包还是超。说明 tabBar 页面里还压着大图或大 SDK。把 tab 页的图片改成网络图,非首屏模块拆成异步组件,通常还能再挤出 100~200KB。

四、结果:体积和启动一起下来了

指标瘦身前瘦身后变化
主包体积2.34MB1.08MB-54%
分包数量03按业务域切分
首次启动(4G 冷启)2.8s1.4s-50%
首页可交互时间3.2s1.6s-50%
功能与埋点—全部保留无删减

提审一次通过。比体积更实际的变化在用户侧:客户后台的首页跳出率降了十几个点——原来不少用户就是在白屏那两秒里退出的。

五、别让它再胖回去

瘦身不是一次性动作。三个月不设卡,包体一定回到 2MB 附近。建议把这四条固化成上线前的检查项:

一分钟自查:打开开发者工具的依赖分析,看「图片」和「第三方库」两项占比加起来有没有超过 40%。超了,就还有 300KB 以上的空间可以腾,而且不用改任何业务逻辑。

写在最后

包体积这件事,本质是把「谁该随包走、谁该用的时候再拿」想清楚。想清楚之后,功能一个没少、代码没怎么删,包就瘦下来了,启动也快了。如果你们的小程序正卡在提审,或者首页慢得让人着急,可以拨 18833330416 或在网站留言,我们先把依赖和资源盘一遍,再判断该瘦身还是该重构。