Appearance
微信小程序体积限制说明
微信官方对小程序包体积有严格限制:
- 主包大小限制:不超过 2MB。
- 所有分包及整包总大小限制:不超过 20MB。
在引入大量业务页面、静态图片或第三方图表/富文本组件时,若主包体积超出 2MB 将导致微信开发者工具无法上传代码并提示“包体积超出限制”。
关键优化手段
采用生产发布模式编译(关键)
- 开发调试模式下未进行代码压缩与混淆,体积会偏大。
- 必须使用 发布模式 编译构建:bash
cd view/uniapp npm run build:mp-weixin - 在微信开发者工具中上传
dist/build/mp-weixin/目录下的产物,而非dist/dev/mp-weixin/。
静态图片全部上云(CDN 外链)
- 禁止在本地
static/目录存放大于 20KB 的背景图或高清图。 - 将图片上传至 OSS / COS 对象存储,页面中直接引用 CDN 完整 URL(如
https://cdn.yourdomain.com/static/...)。
严格执行分包加载(subPackages)
在 view/uniapp/pages.json 中,保持主包仅包含 TabBar 核心 4~5 个基础页面(首页、分类、购物车、个人中心),其余所有业务模块(商品详情、订单列表、分销中心、积分商城、设置页等)全部移入 subPackages 分包中。
开启微信开发者工具压缩优化
在微信开发者工具右上角【详情】 -> 【本地设置】中,确保勾选:
- ✅ 上传代码时自动压缩脚本文件
- ✅ 上传代码时自动压缩样式文件
- ✅ 上传代码时过滤无依赖文件