不能靠删代码硬减，需将static/大图、视频等搬至cdn并精准控制分包依赖；定位主包膨胀须统计unpackage/dist/build/mp-weixin各目录大小，禁用相对路径引用，启用manifest.json中"optimization":{"subpackages":true}，避免preloadrule误配及动态路径全量打包。

直接结论：不能靠删代码硬减，得把 static/ 里的大图、视频、字体、第三方 sdk 搬到 cdn，同时精准控制分包依赖，否则主包永远卡在 2mb 边缘。

怎么快速定位哪个文件在撑爆主包

微信不报错，只在上传时静默拦截，所以必须自己摸清真实体积构成。

• 运行 npm run build:mp-weixin 后，打开 unpackage/dist/build/mp-weixin 目录
• 用系统自带的「显示简介」或命令 du -sh * 统计各文件夹大小，重点关注 static/、common/、pages/ 下的 JS 和图片
• 用微信开发者工具右键分包目录 → “在资源管理器中打开”，按大小排序，一眼揪出 >500KB 的 JS 或图片
• 别信 HBuilderX 构建日志里那句模糊的“构建完成”，它不反映真实产物体积

为什么外部化图片后体积没变小

外部化不是拖文件到 CDN 就完事——只要路径还是相对路径或 alias，Webpack 仍会把它打包进 JS。

uni-app

uni-app 是基于 Vue 的跨端开发框架，适合开发 H5、App、小程序、鸿蒙和多端业务应用。

下载

• 必须用绝对 HTTPS URL：<image :src="'https://cdn.example.com/img/banner.jpg'></image>，禁用 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 引用的资源，只要路径可静态解析，就进包

为什么分包后主包反而更大了

核心陷阱在于：被两个及以上分包引用、但主包完全没用的模块，uni-app 默认全塞进主包 common/vendor.js。

• 例如一个 utils/request.js 被 subA 和 subB 同时 import，哪怕 app.vue 一行都不引用，它也会进主包
• 解决办法是启用分包优化开关："optimization": {"subPackages": true}，加在 manifest.json 的 mp-weixin 配置下
• 更彻底的方案是写 Webpack 插件（如 SplitUtilPlugin），自动识别并把多分包共享、主包未引用的模块下沉到对应分包的 vendor
• 检查 preloadRule 配置，避免给 "*" 或 "pages/**" 预加载，否则目标页面资源会被强行拉进主包

国际化语言包怎么不进主包

把所有语言文件（zh-CN.js、en-US.js）全打进主包，是典型的“默认懒惰式”写法，极易超限。

• 主包只保留默认语言（如 zh-CN.js），其他语言文件全部挪到某个分包目录下，比如 subI18n/i18n/en-US.js
• 在进入该分包页面时，用 import() 动态加载对应语言包，再调用 mergeLocaleMessage 注入
• 确保 i18n 初始化逻辑不依赖未加载的语言文件，否则首屏白屏
• 不要用 require(`./i18n/${lang}.js`) 这种动态字符串路径，Webpack 会打包全部匹配文件

最常被忽略的一点：体积问题从来不是单点问题。改了图片路径但忘了删 static/ 旧文件，开了 subPackages: true 但 preloadRule 还在乱配，或者语言包抽出去了却在主包某处写了 import('./i18n/ko-KR') —— 这些细节一叠加，2MB 就又回来了。