Vue / 系统课时
优化首屏加载
优化首屏加载
本课把“页面能打开”推进到“首次访问更快”。你将通过路由懒加载、第三方依赖分包和构建产物分析,减少入口包体积,并用同一套环境记录优化前后的请求数量与资源体积,避免只凭主观感受判断效果。
学习目标
- 将非首屏页面改为按路由动态加载
- 使用 Vite 拆分体积较大的第三方依赖
- 生成资源分析报告并完成前后对比
建立可比较的优化基线
首屏优化必须先固定测试条件。使用生产构建、浏览器无痕窗口和禁用缓存的首次访问作为基线,至少记录入口 JavaScript 总体积、最大首屏文件、首屏请求数和页面关键内容出现时间。开发服务器包含热更新代码,不适合比较最终体积。
先在未修改配置时执行一次生产构建:
npm run build预期输出
vite v<VERSION> building for production...
dist/index.html <SIZE>
dist/assets/index-<HASH>.js <SIZE>
✓ built in <TIME><VERSION>、<HASH>、<SIZE> 和 <TIME> 会随环境变化。保存这次输出,并在浏览器 Network 面板中记录首次进入默认页面时实际下载的 JavaScript 文件。
按路由拆分页面代码
若在路由文件顶部直接导入所有页面,登录页也会被迫下载用户管理、报表和图表页面代码。将非必要页面改为动态导入后,Vite 会为它们生成独立 chunk,只在路由真正访问时请求。
import { createRouter, createWebHistory, type RouteRecordRaw } from 'vue-router'
const routes: RouteRecordRaw[] = [
{
path: '/login',
component: () => import('../views/LoginView.vue')
},
{
path: '/',
component: () => import('../layouts/AdminLayout.vue'),
children: [
{
path: 'dashboard',
component: () => import('../views/DashboardView.vue')
},
{
path: 'reports',
component: () => import('../views/ReportsView.vue')
}
]
}
]
export default createRouter({
history: createWebHistory(),
routes
})预期结果
首次访问 /login 时不会下载 ReportsView-<HASH>.js。
进入 /reports 后,浏览器才新增请求 ReportsView-<HASH>.js。动态导入应放在路由边界,而不是把每个很小的组件都拆成单独请求。过度拆分会增加网络往返和 chunk 管理成本。
拆分重型第三方依赖
路由懒加载解决“页面何时加载”,manualChunks 解决“公共依赖如何归组”。下面把 Vue 运行时、Element Plus 和 ECharts 分开,避免一个超大的 vendor 文件阻塞首屏。先安装构建分析插件:
npm install -D rollup-plugin-visualizer预期输出
added <N> packages, and audited <N> packages in <TIME>然后更新 vite.config.ts:
import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'
import { visualizer } from 'rollup-plugin-visualizer'
export default defineConfig({
plugins: [
vue(),
visualizer({
filename: 'dist/stats.html',
open: false,
gzipSize: true,
brotliSize: true
})
],
build: {
rollupOptions: {
output: {
manualChunks(id) {
if (!id.includes('node_modules')) return
if (id.includes('echarts')) return 'vendor-echarts'
if (id.includes('element-plus')) return 'vendor-element-plus'
if (id.includes('/vue/') || id.includes('vue-router') || id.includes('pinia')) {
return 'vendor-vue'
}
}
}
}
}
})配置生效后再次执行构建:
npm run build预期输出
dist/assets/vendor-vue-<HASH>.js <SIZE>
dist/assets/vendor-element-plus-<HASH>.js <SIZE>
dist/assets/vendor-echarts-<HASH>.js <SIZE>
dist/stats.html <SIZE>
✓ built in <TIME>
分析报告重点看两件事:首屏入口是否仍包含只在报表页使用的模块,以及某个依赖是否因重复版本或错误导入占据异常大的面积。分包名称只是手段,最终目标是让首次访问只下载必要代码。
对比优化前后的变化
在相同网络、相同页面和禁用缓存条件下重新记录数据。建议使用下面的表格格式,把真实结果填入项目文档。
| 指标 | 优化前 | 优化后 | 判断 |
|---|---|---|---|
| 首屏 JavaScript 下载量 | <BEFORE_KB> |
<AFTER_KB> |
越低越好 |
| 首屏 JavaScript 请求数 | <BEFORE_COUNT> |
<AFTER_COUNT> |
不宜因过度拆分显著增加 |
| 最大首屏 chunk | <BEFORE_KB> |
<AFTER_KB> |
避免单文件过大 |
| 首屏关键内容出现时间 | <BEFORE_MS> |
<AFTER_MS> |
至少重复测试三次 |
若体积下降但请求数暴增,说明拆分粒度可能过细;若入口包仍很大,应回到分析报告检查全量组件注册、图标库整体导入和报表依赖是否进入首屏。
验收边界与常见问题
优化完成后应同时满足:默认路由可以正常刷新、懒加载页面访问无 404、生产环境静态资源路径正确、旧浏览器目标未被意外改变。分包策略变更还会影响缓存命中,因此稳定的公共依赖 chunk 通常比频繁变化的业务代码更适合长期缓存。
不要只比较压缩前源码体积。浏览器真正下载的是经过 gzip 或 Brotli 压缩后的文件,而解析和执行成本又与压缩后体积不完全等价。体积、请求数量和实际加载时间需要一起观察。