行业动态

Vue项目越拆越碎,打包体积反倒涨了三成

无锡枫泽云创 阅读约 6 分钟

摘要:一线经验拆解Vue项目拆分后打包体积反涨三成的真实原因:公共依赖被复制、chunk拆得过碎、sideEffects标记丢失,并给出splitChunks配置与拆分粒度的量化判断标准,附不适用场景说明。

Vue项目越拆越碎,打包体积反倒涨了三成
Vue项目越拆越碎,打包体积反倒涨了三成

上周帮一个团队看构建产物,他们刚做完一轮目录重构,把原来一个三十多页面的管理端按业务线拆成七个独立模块。听起来挺规整。结果 dist 目录从 4.2MB 涨到 5.5MB,gzip 后也多了三成多。负责人很困惑:代码明明拆开了,怎么包还胖了?

这不是个例。我这两年经手的项目里,拆目录之后体积反弹的至少占一半。很多人把「拆分」和「变小」划了等号,这个假设本身就不成立。

先说清楚膨胀从哪来。

第一个来源是共享依赖被打散。原来一个入口,公共的组件库、工具函数、请求封装只算一次。拆成七个模块后,如果每个模块各自 import 同一批文件,而构建配置没有做跨模块的依赖提升,那么这份代码就会被复制进每个 chunk。一个 60KB 的公共组件目录,复制七份就是 420KB。模块越多,放大倍数越吓人。

第二个来源是路由懒加载被拆过头。有人把每个页面都切成独立 chunk,连一个只被一个页面引用的 200 行工具文件也单独抽出来。浏览器发一个请求要付连接开销,chunk 数量从十几个涨到七八十个,总下载量没降,首屏反而更慢。体积统计里那些几十字节的碎片文件,加起来能占几百 KB 的请求头开销。

第三个来源是副作用标记丢失。拆分时新建的模块入口如果没正确标注 sideEffects,打包器就不敢做 tree-shaking,整包保留。这个坑很隐蔽,构建日志里看不出异常,只有对比产物才露馅。

我见过一个更典型的具体场景。某电商后台,商品模块和订单模块共用一套表单校验规则,重构时各自拷了一份到自己的 utils 目录,理由是「解耦」。三个月后改一条规则要改两处,还漏了一处,线上出现金额校验不一致。体积涨了多少?两套规则加各自的依赖,多出 180KB 左右。这种「复制式解耦」是拆碎之后体积反涨最常见的推手,也是最不该做的。

怎么解决,得从构建配置和拆分粒度两头下手。

先看配置。多入口或 monorepo 场景,用 splitChunks 的 cacheGroups 把公共依赖强制合并,给 vendor 和 common 设好 minChunks 阈值,比如被两个以上入口引用就抽公共包。这一步能直接消掉大部分重复。同时把每个模块入口的 sideEffects 标清楚,纯工具文件标 false,带副作用的样式和 polyfill 标 true,别图省事全标 false,那会切掉必要的初始化代码。

再看粒度。我的判断很直接:页面级别的懒加载保留,函数级别的拆分基本没必要。一个文件只被一处引用,就让它跟着宿主走,不要单独成 chunk。判断标准可以量化,单文件压缩后低于 15KB 且引用次数小于 2,就不值得独立拆包。把这条写进团队规范,比事后分析产物管用得多。

还有一个动作容易被忽略:拆分之后要做一次产物对比。用构建分析工具导出依赖图,看每个 chunk 里有没有重复出现的模块路径。我习惯让团队在重构分支上跑一次基线对比,体积涨幅超过 8% 就打回。这个门槛定得死一点,能挡住绝大多数「为了拆而拆」的改动。

说一个不适用的情况。如果项目本身已经用模块联邦做了运行时共享,或者所有模块都在同一个应用壳里按需加载、公共依赖走统一注册,那么上面那套 cacheGroups 的配置反而多余,强行合并会破坏运行时的独立性。这种架构下要盯的是共享依赖的版本收敛,不是打包配置。

另外,如果拆分的初衷是团队协作边界而不是体积,那体积涨一点是合理代价。七个小组并行开发,各自独立发版,多出几百 KB 换来的迭代效率,我觉得值。这时候该做的是接受体积,把优化重点放到首屏资源优先级上,而不是回头把模块又捏回去。

拆分的目的是让变化隔离,不是让字节变少。这两件事经常打架。下次重构前,先在分支上跑一次构建,把产物体积当硬指标卡住,再动目录结构。别等上线了才发现,代码是清爽了,用户的流量账单也清爽了。

专业的软件开发服务

立即联系我们,获取免费的方案评估和报价

立即咨询
联系我们:18706176160