微信小程序主包过大终极解决方案

随着小程序项目的不断迭代升级,避免不了体积越来越大。微信限制主包最多2M,然而我们的项目引入了直播插件直接占了1.1M,导致必须采用一些手段去优化。下面介绍一下优化思路和终极解决方案。

1.分包

我相信几乎所有人都能想到的方案,基本上这个方案就能解决问题。具体如何实现可以参照官方文档这里不做过多说明。(基础能力 / 分包加载 / 使用分包 (qq.com)),但是有时候你会发现分包之后好像主包变化不是很大,这是为什么呢?

  • 痛点1:通过依赖分析,如果分包中引入了第三方依赖,那么依赖的js仍然会打包在主包中,例如echarts、wxparse、socket.io。这就导致我们即使做了分包处理,但是主包还是很大,因为相关的js都会在主包中的vendor.js

  • 痛点2:插件只能在主包中无法分包,例如直播插件直接占据1M

  • 痛点3:tabbar页面无法分包,只能在主包内

  • 痛点4:公共组件/方法无法分包,只能在主包内

  • 痛点5:图片只能在主包内

2.图片优化

图片是最好解决的,除了tabbar用到的图标,其余都放在云上就好了,例如oss和obs。而且放在云上还有个好处就是背景图片无需担心引入不成功。

3.tabbar页面优化

这部分可以采用tabbar页面都在放在一个文件夹下,比如一共有4个tab,那么一个文件夹下就只存放这4个页面。其余tabbar的子页面一律采用分包。

4.独立分包

独立分包是小程序中一种特殊类型的分包,可以独立于主包和其他分包运行。从独立分包中页面进入小程序时,不需要下载主包。当用户进入普通分包或主包内页面时,主包才会被下载。 但是使用的时候需要注意:

  • 独立分包中不能依赖主包和其他分包中的内容 ,包括 js 文件、template、wxss、自定义组件、插件等(使用 分包异步化 时 js 文件、自定义组件、插件不受此条限制)
  • 主包中的 app.wxss 对独立分包无效,应避免在独立分包页面中使用 app.wxss 中的样式;
  • App 只能在主包内定义,独立分包中不能定义 App,会造成无法预期的行为;
  • 独立分包中暂时不支持使用插件。

5.终极方案we-script

我们自己写的代码就算再多,其实增加的kb并不大。大部分大文件主要源于第三方依赖,那么有没有办法像webpack中的externals一样,当进入这个页面的时候再去异步加载js文件而不被打包呢(说白了就是CDN)

其实解决方案就是we-script,他允许我们使用CDN方式加载js文件。这样就不会影响打包体积了。

使用步骤

  1. npm install --save we-script
  2. "packNpmRelationList": [{"packageJsonPath": "./package.json", "miniprogramNpmDistDir":"./dist/"}]
  3. 点击开发者工具中的菜单栏:工具 --> 构建 npm
  4. "usingComponents": {"we-script": "we-script"}
  5. <we-script src="url1" />

使用中存在的坑

构建后可能会出现依赖报错,解决的方式就是将编译好的文件手动拖入miniprogram_npm文件夹中,主要是三个文件夹:we-script,acorn,eval5

最后成功解决了主包文件过大的问题,只要是第三方依赖,都可以通过这个办法去加载。

感谢阅读,希望来个三连支持下,转载记得标注原文地址~

相关推荐
张可爱9 分钟前
20251015-Vue3八股文整理
前端
ruanCat9 分钟前
记一次因 vue-router 升级而导致的 uniapp 故障
前端·vue.js
Damon小智10 分钟前
基于 Rokid JSAR 打造精致的 3D 白色飞机模型
前端·虚拟现实
Mintopia12 分钟前
🌌 知识图谱与 AIGC 融合:
前端·javascript·aigc
三十_15 分钟前
TypeORM 基础篇:项目初始化与增删改查全流程
前端·后端
小时前端18 分钟前
事件委托性能真相:90%内存节省背后的数据实证
前端·dom
半木的不二家21 分钟前
全栈框架Elpis实战项目-里程碑一
前端
超能996要躺平24 分钟前
用三行 CSS 实现任意多列等分布局:深入掌握 Grid 的 repeat() 与 gap
前端·css
我叫黑大帅25 分钟前
面对组件的不听话,我还是用了它…………
前端·javascript·vue.js