必须先定位真实体积来源再针对性剥离;运行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:
<image :src="'https://cdn.example.com/img/banner.jpg'>,禁用require('@/static/banner.jpg') - CSS 中
background-image: url()同样受限:不能带查询参数(如?v=1.0)、不能是 base64、域名必须提前配置到小程序后台「业务域名」 - 字体必须写
@font-face { src: url('https://cdn.example.com/font/iconfont.woff2'); },不能放static/fonts/再@import - 所有通过
v-bind:style、import、require引用的资源,只要路径可静态解析,就进包
第三方库怎么按需引入才不白费功夫
写 import { uButton } from 'uview-ui' 不等于按需——没配 babel-plugin-import,照样全量打进包。
- 对
uView:必须在vue.config.js的configureWebpack.plugins中启用插件,并指定libraryName: 'uview-ui' - 对
echarts:禁用import * as echarts from 'echarts',改用import * as echarts from 'echarts/lib/echarts'+ 单独require('echarts/lib/chart/bar') - 自定义组件若内部 import 大型工具库,建议改为异步组件:
const Xxx = () => import('@/components/xxx.vue') node_modules里占大头的通常是echarts、three.js、pdfjs-dist,哪怕只 import 一两个函数,Webpack 默认也会全量引入
最常被忽略的点是:subNVue 和 custom-tab-bar 的路径归属,以及 optimization.subPackages 开关是否真生效——这两个地方一错,再多分包配置都白搭。


















