Vue / 系统课时

构建分析与产物优化

构建分析与产物优化

本课把 Vite 构建优化从“凭感觉删依赖”变成可验证的过程:先得到 bundle 组成证据,再决定分包、按需加载和压缩策略,最后用构建结果确认优化是否真正减少首屏 JavaScript,而不是只把同样的代码换了文件名。

学习目标

  • 通过可视化报告定位体积最大的依赖与 chunk
  • 使用动态导入和 manualChunks 控制按需加载与稳定分包
  • 配置构建压缩并用产物指标验证优化效果

先生成可以追踪的构建报告

安装 rollup-plugin-visualizer 后,可以在生产构建时输出静态报告,查看每个模块在最终 bundle 中占用的体积。

bash
npm install -D rollup-plugin-visualizer

预期输出

text
added <VALUE> packages, and audited <VALUE> packages in <TIME>

<VALUE> 与 <TIME> 会随项目依赖和本机环境变化。

在 vite.config.ts 中只为分析模式启用报告插件,避免每次普通构建都产生报告文件。

ts
import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'
import { visualizer } from 'rollup-plugin-visualizer'

export default defineConfig(({ mode }) => ({
  plugins: [
    vue(),
    ...(mode === 'analyze'
      ? [
          visualizer({
            filename: 'dist/stats.html',
            gzipSize: true,
            brotliSize: true,
            open: false
          })
        ]
      : [])
  ]
}))

使用分析模式构建:

bash
npx vite build --mode analyze

预期输出

text
vite v<VALUE> building for production...
✓ <VALUE> modules transformed.
dist/index.html                  <VALUE> kB
dist/assets/index-<ID>.js        <VALUE> kB
✓ built in <TIME>

实际版本号、模块数、文件哈希、体积和耗时会不同;完成后还会生成 dist/stats.html。

优先处理首屏不需要的大模块

构建报告中最大的模块不一定就是问题。判断顺序应是:它是否进入首屏 chunk、是否能延迟到特定路由或功能、是否存在重复引入。只有确认“首屏不需要却提前下载”时,动态导入才有直接收益。

例如报表页依赖大型图表库,可以让整个页面保持异步:

ts
const ReportsView = () => import('./views/ReportsView.vue')

这是片段示例,依赖已有 Vue Router 路由配置。生效行为是报表页及其专属依赖从首屏依赖图中移出,在用户导航到该页面时再加载。验证方法是在构建报告中确认相关模块进入独立 chunk,并在浏览器 Network 面板中确认首页未请求该 chunk。

用 manualChunks 稳定拆分共享依赖

对于多个页面都会用到、但更新频率与业务代码不同的第三方依赖,可以用 manualChunks 做稳定分组。分包目标不是“文件越多越好”,而是减少无关代码一起失效,并避免巨型主 chunk。

ts
import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'

export default defineConfig({
  plugins: [vue()],
  build: {
    rollupOptions: {
      output: {
        manualChunks(id) {
          if (!id.includes('node_modules')) return

          if (id.includes('vue') || id.includes('vue-router')) {
            return 'vue-vendor'
          }

          if (id.includes('echarts')) {
            return 'charts-vendor'
          }
        }
      }
    }
  }
})

预期结果

text
生产构建会为匹配到的共享依赖生成独立 chunk,例如 vue-vendor-<ID>.js 与 charts-vendor-<ID>.js;具体哈希和体积取决于项目内容。

构建依赖图到优化产物的拆分关系

压缩解决传输体积,不替代代码拆分

Vite 生产构建会对 JavaScript、CSS 等文本资源执行压缩。压缩可以减少文件字节数,但不会改变模块是否在首屏被下载,因此应先解决依赖边界,再关注压缩算法和服务器传输。

可以显式保留默认的 esbuild 压缩并关闭生产 sourcemap:

ts
import { defineConfig } from 'vite'

export default defineConfig({
  build: {
    minify: 'esbuild',
    sourcemap: false
  }
})

预期结果

text
生产构建输出经过压缩的 JavaScript/CSS,且不会生成生产 sourcemap 文件;具体产物名称与体积随源码变化。

如果部署层支持 gzip 或 Brotli,应由 CDN、反向代理或静态服务器返回对应的 Content-Encoding。构建期压缩和 HTTP 内容编码是两层不同的优化:前者缩减源码表达,后者缩减网络传输。

用同一组指标做前后对比

每次优化后至少重新记录主入口 chunk、最大异步 chunk、gzip 或 Brotli 体积,以及首页实际请求的 JavaScript 总量。若总产物体积略增,但首屏请求明显下降且异步页面只在需要时加载,这通常是更合理的结果。

最终判断标准不是“bundle 数量更多”或“单文件更小”,而是依赖是否出现在正确的加载阶段、缓存边界是否稳定、压缩是否由部署链路真正启用。构建分析提供证据,分包和按需加载改变依赖边界,压缩再负责减少传输成本。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

构建分析与产物优化

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通