Vue 3 打包后单个 chunk 2.1MB,manualChunks 怎么拆才不重复加载

先确认体积到底堆在哪个包上

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,最后查重复模块并复测体积。拆包不是越多越好,缓存命中率才是判断标准。

您可以还会对下面的文章感兴趣: