uniapp命令行分包
uniapp 命令行分包方法
uniapp 支持通过命令行进行分包操作,适用于优化应用加载速度和体积管理。以下是具体实现方式:
修改 manifest.json 配置
在项目根目录的 manifest.json 文件中添加分包配置:

"subPackages": [
{
"root": "subpackageA",
"pages": [
"pages/subA/page1",
"pages/subA/page2"
]
},
{
"root": "subpackageB",
"pages": [
"pages/subB/page1"
]
}
]
通过命令行构建分包 使用 HBuilderX 或命令行工具执行分包构建:
# 开发环境构建
npm run dev:%PLATFORM% -- --subpackage subpackageA
# 生产环境构建
npm run build:%PLATFORM% -- --subpackage subpackageA
其中 %PLATFORM% 替换为目标平台(如 mp-weixin)

分包预加载配置
在 pages.json 中配置预加载规则:
"preloadRule": {
"pages/main/index": {
"network": "all",
"packages": ["subpackageA"]
}
}
注意事项
- 分包目录需位于项目根目录下
- 主包必须包含 app 启动页面和 tabBar 页面
- 分包之间不能互相引用资源
- 微信小程序分包大小限制为总包 20M,单个分包 2M
查看分包信息 构建完成后,在 dist 目录下会生成对应的分包结构,可通过开发者工具查看分包加载情况。






