必须通过微信开发者工具“代码依赖分析”或手动检查unpackage/dist/build/mp-weixin目录文件大小来定位主包体积大户，>500KB的.js/.png文件及未正确外部化的静态资源是主要超限来源。
主包超 2MB 不会报错，但微信开发者工具上传时直接拦截，且不提示具体哪部分超标——必须自己动手摸清真实体积构成，否则所有优化都是蒙眼打靶。
怎么看清楚主包里到底谁在撑体积
别信 HBuilderX 构建日志里的模糊提示，它只说“可能超了”，不列文件。真正有效的路径是：
- 执行
npm run build:mp-weixin后，打开unpackage/dist/build/mp-weixin目录 - 右键 → “在资源管理器中打开”，对
pages/、components/、static/等子目录按大小排序 - 重点盯 >500KB 的
.js或.png文件；node_modules不进分包，但static/下的图片、components/里被多处引用的组件 JS 全算主包 - 用
npx size-limit配合size-limit.config.js测app.js或pages/index/index.js，确认是否因import()被误打包或<style scoped>重复注入
为什么静态资源移到 CDN 后体积还是没变
常见误区是把图片从 static/ 拖到 CDN 就完事——只要代码里还用 require()、import 或相对路径（比如 v-bind:style）引用，Webpack 就照常打包进去，CDN 白配。
- 图片必须写死绝对 HTTPS URL：
<image :src="'https://cdn.example.com/logo.png'>，禁用require('@/static/logo.png') - CSS 中字体要用
@font-face { src: url('https://cdn.example.com/font.woff2'); }，不能放static/fonts/再@import - 背景图同理：
background-image: url('https://cdn.example.com/bg.jpg');，带变量拼接（如url(${cdn}/a.png)）也会触发全量打包 - 外部化后必须加 fallback：图片加载失败要显示占位符；
uni.downloadFile下载的资源不算包体积，但首屏延迟高，不能替代外部化
分包配置开了但 vendor.js 还是 1.8MB 怎么办
很多项目卡在 2.1MB 就停住，其实只是没开分包优化开关。在 manifest.json 的 mp-weixin 节点下，必须同时配齐这两项：
{
"mp-weixin": {
"optimization": {
"subPackages": true,
"runtimeCompress": true
}
}
}
-
runtimeCompress不是“压缩图片”，而是移除 JS 中的注释、空格、未使用的调试逻辑，实测可减 1.2–1.8MB -
subPackages: true才能让分包 JS 不再塞进vendor.js；二者缺一不可 - HBuilderX 里勾选「运行时是否压缩代码」只是开发阶段模拟，不生效于正式构建
- 开启后若出现分包页面白屏，大概率是某分包内用了主包未提供的 polyfill（比如
Promise），需手动在分包入口加import 'es6-promise/auto'
echarts/uView 这类重型库怎么处理才不进主包
echarts 完整版 2.1MB，但业务中通常只用柱状图+折线图，根本不需要地理坐标、3D 渲染、SVG 导出等模块。直接引入全量包，等于主动往主包塞炸弹。
- 改用
echarts-for-weixin官方精简版（仅含基础图表，约 350KB） - 用
echarts@5.4.3+ webpack 别名，定向alias到echarts/lib/chart/bar和echarts/lib/component/toolbox等最小路径 - 更激进：把图表逻辑抽成独立分包，主包只留骨架，分包内再
import echarts—— 这样主包彻底不沾边 -
uView同理：不要import uView from 'uview-ui'，改用import { uniButton }等按需引入方式
最易被忽略的是：pages.json 里漏写某个新页面路径，等于默认归入主包；components/ 根目录下放了 uView 全量组件，哪怕只用了 uni-button，整个 UI 库仍被打进主包；<style scoped> 在多个页面引用同一 common.scss 却没抽成独立 CSS，会导致样式代码在每个页面 JS 里冗余一份。
