技术分享

小程序包体积超2M被拒审三次后我才明白分包不是随便切切

无锡枫泽云创 阅读约 7 分钟

摘要:从一次主包超限被拒审三次的整改经历切入,拆解分包失效的常见原因:依赖仍挂在主包、图片未压缩、跨分包引用导致依赖回提。给出按业务模块切分、按需引入验证、独立分包适用边界的具体做法,并说明轻量小程序不必强行分包。

小程序包体积超2M被拒审三次后我才明白分包不是随便切切
小程序包体积超2M被拒审三次后我才明白分包不是随便切切

去年十一月底,一个做社区团购的客户找到我。他们的小程序提审三次,三次都被打回,理由都是同一个:主包超过2M。第三次驳回意见里还多了一行字,大概意思是“建议对代码包进行合理拆分”。对方的开发负责人把这句话截图发给我,说我们早就分包了,四个分包,怎么还超?

我让他把构建产物发过来。打开一看就明白了。主包里躺着三样东西:一个完整引入的UI组件库、两张没压缩的活动长图、还有一份接近300K的本地城市数据JSON。四个分包加起来不到600K,全是空壳页面。这种切法在构建工具眼里叫“分包”,在审核系统眼里等于没分。

这事不新鲜。我这两年接手过的分包整改,十有八九栽在同一个认知上——把分包当成文件夹整理,以为把页面挪到另一个目录就完事了。实际上分包解决的是加载时机问题,不是文件摆放问题。

先说清楚为什么会被卡。小程序的代码包有明确上限,单个包体2M,整体不超过20M。主包是用户打开就必然下载的那一部分,分包要等跳转到对应页面才触发下载。审核卡主包体积,卡的是首屏加载体验。你把页面切出去了,但页面依赖的组件、图片、工具函数还挂在主包里,主包体积纹丝不动,审核当然不认。

更麻烦的是有些依赖是隐性的。比如你在主包某个页面里import了一个工具函数,这个函数内部又引了一堆东西,构建工具会把这些全部打进主包。你在分包页面里再引一次,它不会重复打包,但主包那部分已经存在了。很多人查体积只看页面文件大小,忽略了依赖树。我一般让人直接看构建分析报告里的模块占比,哪个模块占了主包的大头,一目了然。

那次整改我们做了三件事。第一,把UI组件库从主包整体引入改成按需引入,只保留首页实际用到的六个组件,主包直接掉下来400多K。第二,两张活动长图挪到分包,用的时候从网络拉,本地只留一张压缩到80K以内的占位图。第三,那份300K的城市数据改成按需请求接口,本地只留省份列表。三轮下来主包从2.3M降到1.1M,第四次提审当天过。

这里有个细节值得说。按需引入不是把import语句改短就行,得确认构建工具的tree-shaking真的生效了。我见过有人改了引入方式,体积一点没变,原因是组件库的入口文件把所有组件都export了一遍,摇树摇不掉。这种情况要么换引入路径,直接指向单个组件文件,要么在构建配置里做排除。判断方法很简单,改完打一次包,对比模块分析里那个库的占比,数字没动就是没生效。

再说图片。小程序里图片占主包体积太常见了。一张1080宽的运营图,不压缩动辄两三百K,放三张主包就告急。我的做法是主包内不放超过100K的单图,超过就上CDN,本地只放低清占位。有人担心网络图加载慢,其实首屏那张图用本地占位先撑住布局,网络图加载完替换,体验上感知不到。真正影响体验的是主包太大导致首次打开白屏时间长,这个账要算清楚。

分包本身也有讲究。我见过最离谱的切法是把一个业务流程拆成七八个分包,每个分包一两个页面。结果用户点下一步就要等一次分包下载,跳转卡顿比主包超限还难受。分包数量不是越多越好,我倾向按业务模块切,一个完整流程放一个分包里,用户进入这个流程只下载一次。比如商品详情加下单加支付放一起,个人中心加订单列表放一起。这样一个分包控制在500K到800K之间,下载一次能撑完整个流程。

还有一种情况是分包之间互相引用。A分包里的页面引了B分包里的组件,构建工具处理不了这种跨分包依赖,要么报错要么把依赖提到主包。提到主包就等于白分。所以切分包之前得先理清依赖关系,公共组件要么放主包(前提是体积可控),要么复制到各分包里各自维护。复制听起来不优雅,但比依赖纠缠导致主包膨胀实在。说实话,公共代码抽到主包这件事,很多团队做过头了,把一堆低频组件也塞进主包,图的是“复用方便”,代价是每个用户都要下载。

独立分包是另一个容易被忽略的点。有些页面用户可能从分享链接直接进来,比如活动页、商品详情页。这类页面如果放在普通分包里,用户进来要先下载主包再下载分包,链路长。独立分包可以不依赖主包运行,适合这种直达场景。但它有约束,独立分包里不能直接用主包的全局状态和公共方法,得自己带一份。用之前想清楚这个页面是不是真的会被单独打开,不是的话没必要上独立分包,徒增维护成本。

说说什么情况下这套做法不适用。如果你的小程序本身就很轻,主包1M出头,页面不到十个,那真没必要折腾分包。硬切反而增加构建复杂度和跳转等待。我见过一个工具类小程序,总共八个页面,非要拆两个分包,结果用户从首页进设置页要等分包下载,体验倒退。分包是体积超标时的解法,不是架构标配。先量体积,再决定动不动刀。

回到开头那个客户。整改完之后他们的开发负责人问我,以后怎么避免再踩这个坑。我说很简单,每次发版前跑一次构建分析,盯住主包里排名前五的模块,任何一个超过200K就查来源。这个动作花不了十分钟,比提审被拒三次再回头查省事得多。体积这件事,平时不管,攒到审核那天就是硬伤。

专业的软件开发服务

立即联系我们,获取免费的方案评估和报价

立即咨询
联系我们:18706176160