subPackages 配置生效需 manifest.json 开启、pages.json 结构与目录层级严格对齐;路径须相对 root、跳转用完整路径、慎用 preloadRule。

subPackages配置生效是前提,否则所有页面都打到主包,2MB 限制根本过不了。uni-app 的分包不是“写个配置就完事”,它依赖 manifest.json 开关、pages.json 结构、目录层级三者严格对齐,缺一不可。
manifest.json 必须开启 subPackages 优化
很多项目卡在这一步——光改了 pages.json,但没在 manifest.json 里打开开关,编译时完全不识别 subPackages 字段。
正确写法(注意字段名是 subPackages,不是 subPackage 或 subpackages):
{
"mp-weixin": {
"optimization": {
"subPackages": true
}
}
}
- 字段名大小写敏感,
subPackages是唯一有效值 - 必须放在
mp-weixin下,其他平台如mp-qq同理但不互通 - HBuilderX 用户:检查是否勾选了「运行时压缩代码」,否则 vendor.js 容易撑爆主包
pages.json 中 subPackages 的路径必须相对 root
常见错误是把分包页面的 path 写成全路径,比如 "path": "pagesA/list/list"。实际它必须是相对于 root 的路径,即去掉 root 前缀后剩下的部分。
假设你建了目录 pagesA/list/list.vue,且 root: "pagesA",那么 path 只能写 "list/list",不是 "pagesA/list/list",也不是 "list"(除非你把文件直接放 pagesA/list.vue)。
-
root值就是分包文件夹名,与pages目录同级,例如pagesA、subpkg -
pages数组里的每个path,开头不能带斜杠,也不能含pages或subpkg等前缀 - 分包内可自带
static目录,里面图片/字体等资源自动归属该分包,不占主包体积
分包页面跳转必须用完整路径,且不能省略 .vue 后缀
uni-app 编译为微信小程序时,路由系统依赖真实路径。从主包跳分包页,navigator 的 url 或 uni.navigateTo 的 url 参数必须写全,且路径中不含 pages/ 前缀。
Windows 微信自动发送工具。支持搜索微信联系人并发送文字、图片、文件和**批量文件**。通过 GUI 自动化控制微信窗口,无需微信开放接口。触发场景: 离开电脑时,远程指令OpenClaw发送图片/文件给微信联系人。条件: 微信打开并登录(允许最小化)。举例:1、把桌面上的龙虾图片发送给张三(默认微信发送);2、查找D盘最新的报价单Excel表并发送给李四(默认微信发送);3、搜索报价单并批量发送给联系人。
例如分包 root: "pagesA" 下有 pagesA/detail/detail.vue,跳转写法只能是:
<navigator url="/pagesA/detail/detail">跳转</navigator>
- 路径以
/开头,但不要加pages/—— 这是主包逻辑,分包路径是独立命名空间 - 不能写成
/detail/detail或detail/detail,否则微信侧报page frame not found - URL 中传参正常,如
/pagesA/detail/detail?id=123,onLoad能拿到
预加载 preloadRule 很容易拖慢首屏,慎配
preloadRule 看似提升体验,但若配置不当,会显著延长当前页面的 ready 时间。微信开发者工具控制台出现 preloadSubpackages 日志并不等于“快”,只是“触发了”。
- 只对用户高概率后续访问的分包做预载,比如首页点击“我的订单”后大概率进订单列表,可在首页配置预载
pagesB -
network: "all"会强制弱网下也下载,可能卡住当前页;默认wifi更稳妥 - 避免在启动页(如
pages/index/index)或 tabbar 页面上配大量预载,主包压力反而更大
真正影响体验的,往往不是“第一次进分包慢”,而是“主包 vendor.js 太大导致首页白屏久”。优先砍掉主包里的大图、第三方 SDK、未用的 UI 库,比堆 preloadRule 实在得多。










