需先精确统计unpackage/dist/build/mp-weixin下各分包文件夹总大小，再用系统排序定位＞500KB的JS或图片；配合npx size-limit检测入口文件，排查scoped样式冗余、静态资源未外部化（须用绝对HTTPS URL）、preloadRule误配致主包膨胀、动态路径字符串引发全量打包等问题。
uni-app 分包体积超 2M 怎么快速定位具体哪个文件在撑大体积
分包超限不是报错，而是上传时被微信开发者工具拦截，且不明确说哪部分超了。关键得先摸清真实体积构成。
直接看 unpackage/dist/build/mp-weixin 目录下各分包文件夹（如 subN）的总大小，别信 HBuilderX 的“构建日志”里那行模糊提示；用系统命令或资源管理器精确统计，node_modules 不会打进分包，但 static/、components/、pages/ 下的 JS/CSS/图片全算。
- 用微信开发者工具右键分包目录 → “在资源管理器中打开”，再按大小排序，一眼揪出 >500KB 的 JS 或图片
-
npm run build:mp-weixin后立刻执行npx size-limit（需配size-limit.config.js检查分包入口文件） - 特别注意：Vue 单文件组件里
<style scoped>编译后会重复注入，多个页面引用同一common.scss但又没抽成独立 CSS 文件，会导致样式代码在每个页面 JS 里冗余一份
uni-app 静态资源（图片/字体）怎么外部化才真正减小分包体积
外部化不是简单把图片从 static/ 拖到 CDN，而是要确保打包时不被打包进分包 JS 或 JSON 中——否则体积一分没少。
核心原则：所有通过 require()、import、v-bind:style 或 background-image: url(...) 引用的资源，只要路径是相对路径或 alias，都会被 Webpack 打包进去；必须用绝对 HTTP(S) URL，且不能带变量拼接（否则会被当静态资源处理）。
- 图片：改
<image :src="'https://cdn.example.com/img/logo.png'">，禁用require('@/static/logo.png') - 字体：CSS 中写
@font-face { src: url('https://cdn.example.com/font/iconfont.woff2'); }，别放static/fonts/下再 @import - 注意：
uni.downloadFile下载的资源不算分包体积，但首次加载延迟高；外部化后务必加 loading 状态和失败 fallback，比如图片挂了显示占位符
分包预加载（preloadRule）为什么反而让主包变大
微信小程序的 preloadRule 机制会把目标页面的 JS/WXML/WXSS 提前下载并缓存，但它**不区分主包还是分包**——如果配置不当，会把本该在 subN 里的文件强行拉进主包。
常见错误是给根路径 "*" 或 "pages/**" 配置了 preload，导致所有页面资源被主包“劫持”。检查 pages.json 的 subN 节点是否漏写了 "root": "subN"，以及 preloadRule 的 network 字段是否为 "all"（默认值），这会让弱网下也强制预加载，增加主包初始请求量。
- 只对高频跳转、用户停留时间长的分包页设 preload，例如
"subA/pages/detail/detail" -
network改成"wifi"，避免移动网络下无谓拉取 - 删掉
preloadRule后重新构建，对比unpackage/dist/build/mp-weixin/common/vendor.js大小变化，这是最直接的验证方式
uni-app 使用 uni.getSubNVueById 或 uni.navigateTo 时，动态路径字符串引发的隐式体积膨胀
看似只是字符串拼接，但 Vue 模板编译器 + uni-app 的路由解析逻辑，会把所有可能的路径分支都打包进去——哪怕你写了 v-if="type === 'a'"，只要 uni.navigateTo({ url: '/pages/a/a' + suffix }) 出现在同一个文件，Webpack 就可能把 a/b/c 三个页面全打进当前分包。
根本解法是切断“字符串路径”与“页面模块”的编译期关联：用 uni.switchTab 替代 navigateTo 处理 tab 页面；非 tab 场景下，把跳转逻辑拆到独立的、只负责路由调度的 router.js，并在 pages.json 中显式声明所有目标页面为分包成员，避免运行时路径推导。
- 禁止写
url: '/pages/' + type + '/' + type这类表达式 - 改用对象映射：
const routes = { a: '/pages/a/a', b: '/pages/b/b' }; uni.navigateTo({ url: routes[type] })，确保 key 是字面量 - 如果必须动态，用
uni.preloadPage提前加载目标分包，再navigateTo，避免首次跳转白屏，也防止 Webpack 因无法分析而保守打包
分包体积问题本质是构建时依赖图失控，不是资源多寡的问题。最容易被忽略的是：样式 import 路径、动态 require 表达式、pages.json 里没写全的分包 root 声明——这三处一错，就等于告诉打包器“把这些全塞进来”，其他优化全白搭。
