uni-app 上传提示超过 2M

关注

原创 2026-05-18 11:45:26 47 阅读 AI 写同款· GEO 优化 ›

uniapp微信小程序分包超限？3种实测有效的解决方案（含HBuilder发行技巧）本文针对Uniapp微信小程序开发中主包体积超过2MB限制的常见问题，提供了三种实测有效的解决方案。首先，详细解释了主包超限的根源在于公共组件、静态资源等未合理分包。核心方案包括：善用HBuilder的“发行”编译进行深度代码优化；实施精细化的分包策略，如组件按需引入和静态资源网络化；以及调整构建配置与清理缓存等辅助手段。文章通过实战案例，帮助开发者从根本上为小程序主包“瘦身”。阅读详情

解决方法

方法 1：用发行模式重新编译

在 HBuilderX 里：

▎ 菜单 → 发行 → 小程序-微信（仅发行）

这会生成压缩后的产物到：unpackage/dist/build/mp-weixin/

然后在微信开发者工具里打开这个 build/mp-weixin 目录，再上传。

方法 2

如果发行后仍超 2MB，还需要配置分包（subPackages）

uni-app 在 pages.json 里支持分包，把不常用的页面移出主包。你当前编译产物：

uview-ui：1.8MB（主包必须带）
pages：1.8MB
common：800KB

发行模式压缩后大概能降到 1.5-2MB，可能刚好卡线。如果仍超，可以把非 tabBar的页面配分包：

  // pages.json 新增
  "subPackages": [
    {
      "root": "pages/auth",
      "pages": [
        { "path": "authForm", "style": { "navigationBarTitleText": "xxxx" } },
        { "path": "agree",    "style": { "navigationBarTitleText": "yyyyy" } },
        ...
      ]
    }
  ]
  主包只留 tabBar 的 4 个页面及其直接依赖，其余页面移到
  subPackages。

先试方法 1（改用 build 产物上传），99% 的情况这就够了。