必须先定位真实体积来源再针对性剥离;运行npm run build:mp-weixin后打开unpackage/dist/build/mp-weixin目录按大小排序,重点检查>500KB的app.js、vendor.js及static下图片/字体文件,并用source-map-explorer分析依赖。

主包超 2MB,90% 不是代码太多,而是不该进主包的东西进去了。必须定位真实体积来源,再针对性剥离。
怎么快速找到撑爆主包的文件
别信 HBuilderX 构建日志里那句“构建完成”,它不反映真实产物大小。运行 npm run build:mp-weixin 后,直接打开 unpackage/dist/build/mp-weixin 目录:
- 用系统自带功能按「大小」排序(macOS:列表视图 → 右键列标题选“大小”;Windows:资源管理器 → 查看 → 详细信息 → 点击“大小”列)
- 重点关注:
app.js、common/vendor.js、static/下的 PNG/JPG/SVG/字体文件 - 单个 >500KB 的 JS 或图片,基本就是元凶;一张未压缩的设计稿 PNG 就可能占 2MB+
- 配合
npx source-map-explorer unpackage/dist/dev/mp-weixin/app.js可视化分析依赖占比(需构建时开启 sourcemap)
为什么分包后主包反而更大了
核心陷阱是:一个模块被两个及以上分包引用,但主包完全没用它,uni-app 默认仍塞进 common/vendor.js。比如 utils/request.js 被 subA 和 subB 同时 import,哪怕 app.vue 一行都不引用,它也进主包。
- 必须在
manifest.json的mp-weixin配置下启用:"optimization": {"subPackages": true} - 检查
preloadRule是否误配成"*"或"pages/**",否则会强制把目标页面资源拉进主包 -
subNVue和custom-tab-bar必须放在subPackages指定的根目录内(如subpkgA/custom-tab-bar/),否则静默打入主包 - 避免在主包页面逻辑中调用
uni.getSubNVueById(),这会导致 subNVue 被提前 require
静态资源怎么移出主包才真正生效
拖到 CDN 不等于移出主包——只要路径还是相对路径或 alias,Webpack 仍会打包进去。
- 图片必须用绝对 HTTPS URL:











