先确认体积到底堆在哪个包上
Vite 默认会把第三方依赖打进一个 vendor 包,项目里只要引了组件库、图表库和工具库,这个包很容易涨到两兆以上。不做分析就随手写 manualChunks,最常见的结局是同一个库被拆进两个包,浏览器重复下载,首屏反而更慢。
npm i -D rollup-plugin-visualizer
# vite.config.js 里加上 visualizer() 后执行
npm run build
# 打开 dist/stats.html 看每个 chunk 的构成
报告里按 gzip 后的体积排序,重点看两列:某个包的主要来源,以及同一个模块是否出现在多个 chunk 中。后者就是重复打包的直接证据。
第二步:按变更频率拆,不按目录拆
拆包的目标是缓存命中率,不是把包切得越碎越好。业务代码天天改,依赖几个月才动一次,两者混在一起会让用户每次发版都重新下载全部内容。合理做法是分出 framework、ui、utils 三层。
export default defineConfig({
build: {
rollupOptions: {
output: {
manualChunks(id) {
if (id.includes('node_modules')) {
if (/vue|vue-router|pinia/.test(id)) return 'framework'
if (/element-plus|echarts/.test(id)) return 'ui'
return 'vendor'
}
}
}
}
}
})
注意 id 判断要用 node_modules 路径匹配,不要用包名开头做前缀判断,否则 element-plus/icons-vue 这类带斜杠的子包会被分到错误的组里。
第三步:路由级代码分割
页面组件用动态 import 才会被拆成独立 chunk,静态 import 一律进主包。后台管理类项目动辄二三十个页面,全部静态引入,主包自然下不来。
const routes = [
{ path: '/order', component: () => import('@/views/Order.vue') },
{ path: '/report', component: () => import('@/views/Report.vue') }
]
拆完之后再看报告,首页加载的 chunk 数量应该控制在 5 个以内。如果某个业务页面自己就超过 300KB,多半是把整张图表库或编辑器引了进来,改成按需引入即可。
第四步:验证没有重复
构建日志里出现 duplicated modules 提示,说明有依赖被多个 chunk 共享。此时把该依赖归入统一的 vendor 组,或者用 import.meta.glob 收敛入口。改完执行一次构建,对比主包 gzip 体积,正常情况下能从两兆压到六百KB左右,首屏 LCP 也会同步下降。
小结
顺序是:先用 visualizer 定位体积大户,再按变更频率划分 framework、ui、vendor 三层,业务页面走动态 import,最后查重复模块并复测体积。拆包不是越多越好,缓存命中率才是判断标准。
