Vue / 系统课时

优化首屏加载

优化首屏加载

本课把“页面能打开”推进到“首次访问更快”。你将通过路由懒加载、第三方依赖分包和构建产物分析,减少入口包体积,并用同一套环境记录优化前后的请求数量与资源体积,避免只凭主观感受判断效果。

学习目标

  • 将非首屏页面改为按路由动态加载
  • 使用 Vite 拆分体积较大的第三方依赖
  • 生成资源分析报告并完成前后对比

建立可比较的优化基线

首屏优化必须先固定测试条件。使用生产构建、浏览器无痕窗口和禁用缓存的首次访问作为基线,至少记录入口 JavaScript 总体积、最大首屏文件、首屏请求数和页面关键内容出现时间。开发服务器包含热更新代码,不适合比较最终体积。

先在未修改配置时执行一次生产构建:

bash
npm run build

预期输出

text
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,只在路由真正访问时请求。

ts
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
})

预期结果

text
首次访问 /login 时不会下载 ReportsView-<HASH>.js。
进入 /reports 后,浏览器才新增请求 ReportsView-<HASH>.js。

动态导入应放在路由边界,而不是把每个很小的组件都拆成单独请求。过度拆分会增加网络往返和 chunk 管理成本。

拆分重型第三方依赖

路由懒加载解决“页面何时加载”,manualChunks 解决“公共依赖如何归组”。下面把 Vue 运行时、Element Plus 和 ECharts 分开,避免一个超大的 vendor 文件阻塞首屏。先安装构建分析插件:

bash
npm install -D rollup-plugin-visualizer

预期输出

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

然后更新 vite.config.ts:

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'
          }
        }
      }
    }
  }
})

配置生效后再次执行构建:

bash
npm run build

预期输出

text
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 压缩后的文件,而解析和执行成本又与压缩后体积不完全等价。体积、请求数量和实际加载时间需要一起观察。

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

目录与阅读设置

阅读设置

17

记录一个想法

优化首屏加载

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

登录哪都通