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 分包中。


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

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

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

承信租多门店租赁商城系统官方文档