Vue / 系统课时
构建分析与产物优化
构建分析与产物优化
本课把 Vite 构建优化从“凭感觉删依赖”变成可验证的过程:先得到 bundle 组成证据,再决定分包、按需加载和压缩策略,最后用构建结果确认优化是否真正减少首屏 JavaScript,而不是只把同样的代码换了文件名。
学习目标
- 通过可视化报告定位体积最大的依赖与 chunk
- 使用动态导入和
manualChunks控制按需加载与稳定分包 - 配置构建压缩并用产物指标验证优化效果
先生成可以追踪的构建报告
安装 rollup-plugin-visualizer 后,可以在生产构建时输出静态报告,查看每个模块在最终 bundle 中占用的体积。
npm install -D rollup-plugin-visualizer预期输出
added <VALUE> packages, and audited <VALUE> packages in <TIME><VALUE> 与 <TIME> 会随项目依赖和本机环境变化。
在 vite.config.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
})
]
: [])
]
}))使用分析模式构建:
npx vite build --mode analyze预期输出
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、是否能延迟到特定路由或功能、是否存在重复引入。只有确认“首屏不需要却提前下载”时,动态导入才有直接收益。
例如报表页依赖大型图表库,可以让整个页面保持异步:
const ReportsView = () => import('./views/ReportsView.vue')这是片段示例,依赖已有 Vue Router 路由配置。生效行为是报表页及其专属依赖从首屏依赖图中移出,在用户导航到该页面时再加载。验证方法是在构建报告中确认相关模块进入独立 chunk,并在浏览器 Network 面板中确认首页未请求该 chunk。
用 manualChunks 稳定拆分共享依赖
对于多个页面都会用到、但更新频率与业务代码不同的第三方依赖,可以用 manualChunks 做稳定分组。分包目标不是“文件越多越好”,而是减少无关代码一起失效,并避免巨型主 chunk。
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'
}
}
}
}
}
})预期结果
生产构建会为匹配到的共享依赖生成独立 chunk,例如 vue-vendor-<ID>.js 与 charts-vendor-<ID>.js;具体哈希和体积取决于项目内容。
压缩解决传输体积,不替代代码拆分
Vite 生产构建会对 JavaScript、CSS 等文本资源执行压缩。压缩可以减少文件字节数,但不会改变模块是否在首屏被下载,因此应先解决依赖边界,再关注压缩算法和服务器传输。
可以显式保留默认的 esbuild 压缩并关闭生产 sourcemap:
import { defineConfig } from 'vite'
export default defineConfig({
build: {
minify: 'esbuild',
sourcemap: false
}
})预期结果
生产构建输出经过压缩的 JavaScript/CSS,且不会生成生产 sourcemap 文件;具体产物名称与体积随源码变化。如果部署层支持 gzip 或 Brotli,应由 CDN、反向代理或静态服务器返回对应的 Content-Encoding。构建期压缩和 HTTP 内容编码是两层不同的优化:前者缩减源码表达,后者缩减网络传输。
用同一组指标做前后对比
每次优化后至少重新记录主入口 chunk、最大异步 chunk、gzip 或 Brotli 体积,以及首页实际请求的 JavaScript 总量。若总产物体积略增,但首屏请求明显下降且异步页面只在需要时加载,这通常是更合理的结果。
最终判断标准不是“bundle 数量更多”或“单文件更小”,而是依赖是否出现在正确的加载阶段、缓存边界是否稳定、压缩是否由部署链路真正启用。构建分析提供证据,分包和按需加载改变依赖边界,压缩再负责减少传输成本。