微信小程序之分包加载，解决代码超过2M的方法

原创

咏之随笔 2022-02-11 17:03:52 ©著作权

©著作权归作者所有：来自51CTO博客作者咏之随笔的原创作品，请联系作者获取转载授权，否则将追究法律责任

2017.01.09 小程序上线时，微信限制了代码包不能超过1MB 大小，（现在是2M了）限制大小是出于对小程序启动速度的考虑，希望用户在使用任何一款小程序时，都能获得一种“秒开”体验。然而，2MB 的大小也限制了小程序功能的扩展，小程序业务的发展可能需要更大的体积。
那么，能否有一种方案，在增加小程序包大小的同时，也能保持不错的启动速度呢？
为了解决这个矛盾点，微信推出了「分包加载」这个技术方案。

分包加载的介绍

大部分小程序都会由某几个功能组成，通常这几个功能之间是独立的，但会依赖一些公共的逻辑，并且这些功能通常会对应某几个独立的页面。那么小程序代码的打包，大可不必一定要打成一个，可以按照功能的划分，拆分成几个分包，当需要用到某个功能时，才加载这个功能对应的分包。

对于用户来说，小程序加载流程变成了：

1.首次启动时，先下载小程序主包，显示主包内的页面；

2.如果用户进入了某个分包的页面，再下载这个对应分包，下载完毕后，显示分包的页面。

采用分包加载，对开发者而言，能使小程序有更大的代码体积，承载更多的功能与服务；而对用户而言，可以更快地打开小程序，同时在不影响启动速度前提下使用更多功能

分包的划分

在配置前首先需要开发者规划下各个分包需要容纳的内容，我们建议开发者按照功能划分的的原则，将同一个功能下的页面和逻辑放置于同一个目录下，对于一些跨功能之间公共逻辑，将其放置于主包下，这样可以确保在分包引用这部分功能时，这部分的逻辑一定存在。

在分包划分时，应该注意以下事项：

1.避免分包与分包之间引用上的耦合。因为分包的加载是由用户操作触发的，并不能确保某分包加载时，另外一个分包就一定存在，这个时候可能会导致 JS 逻辑异常的情况，例如报「“xxx.js” is not defined」这样的错误；

2.一些公共用到的自定义组件，需要放在主包内。

分包的配置

当理清了分包的划分后，就可以进行分包的配置了，这一步并不复杂。

假设支持分包的小程序目录结构如下：

微信小程序之分包加载，解决代码超过2M的方法_分包

开发者通过在 app.jsonsubPackages字段声明项目分包结构：

微信小程序之分包加载，解决代码超过2M的方法_分包加载_02

微信小程序之分包加载，解决代码超过2M的方法_加载_03

代码：

{
  "pages": [
    "pages/home/home",
    "pages/index/index",
  ],
  "subPackages": [
    {
      "root": "packageA",
      "pages": [
        "pages/blog/blog"
      ]
    },
    {
      "root": "packageB",
      "pages": [
        "pages/catalog/catalog"
      ]
    },
    {
      "root": "packageC",
      "pages": [
        "pages/kongtiao/kongtiao"
      ]
    }
  ],
}