Skip to content

微信小程序体积限制说明 ​

微信官方对小程序包体积有严格限制:

  • 主包大小限制:不超过 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 分包中。


开启微信开发者工具压缩优化 ​

在微信开发者工具右上角【详情】 -> 【本地设置】中,确保勾选:

  • ✅ 上传代码时自动压缩脚本文件
  • ✅ 上传代码时自动压缩样式文件
  • ✅ 上传代码时过滤无依赖文件

安徽用易软件科技有限公司 · 承信租 V4 官方技术文档中心