小程序基础库 3.12:组件级按需注入上线
小程序基础库在 6 月 11 日推送 3.12 版本,把按需注入从页面级细化到组件级,官方在 60 个采样的头部小程序上测得首屏代码包平均缩小 22%。

此前的按需注入只能按页面切,一个页面里用到的组件全都会打进首屏包。3.12 之后,组件在真正挂载时才注入,一个典型的首页从 486KB 降到 379KB。开发者需要在页面配置里加一个开关,并在组件上声明懒挂载。
另一个改动是分包预下载的时机。旧版在页面跳转时才开始下载,新版允许在上一个页面的空闲期预取,官方数据显示二次跳转的等待时间从 1.4 秒降到 0.6 秒。这个改动对多页流程类小程序影响最大。
兼容性上有一个坑:把组件改成懒挂载后,如果组件里有全局副作用,比如往 window 上挂方法,执行时机就变了。官方在迁移文档里列了 5 类需要检查的写法,并建议先在测试环境开启一周。
上线节奏
基础库按灰度推送,6 月 11 日覆盖约 40% 的活跃设备,预计 7 月中旬全量。开发者工具同步更新到 3.12,可在模拟器里切版本验证。低于 2.9 的旧版本仍会按老逻辑运行,项目里对应的降级分支要保留。
官方同时公布了一组数据:采用组件级按需注入的小程序里,首屏可交互时间中位数下降 0.9 秒,跳出率下降 4.2 个百分点。这些数字来自 60 个采样小程序,样本量约 2100 万次日活。
按需注入的收益与页面结构相关。首页组件超过 20 个的项目收益明显,只有 5 个组件的页面几乎测不出差别;官方在 30 个小程序上做的对照显示,中位数下降 22%,最好的一例是 41%。开了之后要检查自定义组件的注入声明,漏标会导致组件在首屏拿不到数据,表现为一块空白区域。