Vue / 系统课时

路由懒加载与分包

路由懒加载与分包

路由懒加载解决的是首屏一次下载过多页面代码的问题。把页面组件改成动态导入后,构建工具会沿着 import() 建立异步边界;本课再进一步说明怎样让边界稳定、共享依赖不过度重复,并用生产构建验证结果。

学习目标

  • 用 Vue Router 的动态导入实现页面级懒加载
  • 判断页面 chunk、主包与共享依赖之间的边界
  • 用生产构建结果验证分包是否真正生效

让路由组件成为异步边界

在 Vue Router 中,路由记录的 component 可以直接写成返回动态 import() 的函数。导航发生前,页面模块不会执行;首次进入对应路由时,浏览器才请求该异步模块。公共布局可以继续静态导入,让导航骨架保持稳定。

下面的示例假设项目已有 AppLayout.vue、DashboardView.vue 和订单页面文件,可直接作为 src/router/index.ts 使用。

ts
import { createRouter, createWebHistory } from 'vue-router'
import AppLayout from '../layouts/AppLayout.vue'

const router = createRouter({
  history: createWebHistory(import.meta.env.BASE_URL),
  routes: [
    {
      path: '/',
      component: AppLayout,
      children: [
        {
          path: 'dashboard',
          name: 'dashboard',
          component: () => import('../views/DashboardView.vue'),
        },
        {
          path: 'orders',
          name: 'orders',
          component: () => import('../views/orders/OrderListView.vue'),
        },
      ],
    },
  ],
})

export default router

这里真正形成异步边界的是两个 import()。AppLayout 仍进入主依赖图,而两个页面模块会成为可独立加载的入口;它们共同使用的依赖是否再拆成公共 chunk,则由 Vite/Rollup 根据依赖关系继续优化。

路由动态导入与异步分包边界

规划稳定而不过细的分包

稳定边界指的是“哪些功能一起发布和按需加载”相对稳定,而不是要求构建产物文件名固定。生产文件通常带内容哈希,只要代码变化,文件名就可能变化,这是缓存更新机制的一部分。

页面级拆分通常是最可靠的起点。一个业务页面内部几十个小组件没有必要全部再动态导入,否则会产生过多网络请求和加载状态;反过来,把报表、编辑器、订单、系统设置全部静态导入主包,又会把低频功能推回首屏。

可以优先遵循三个边界:公共布局和首屏必要能力进入主依赖图;一级或二级业务页面按路由动态导入;多个懒加载页面共同依赖的大型库交给构建器提取共享 chunk,只有在缓存策略或体积分析明确要求时再配置 manualChunks。

验证生产构建结果

开发服务器按需转换模块,不能代表最终生产 chunk。应执行一次正式构建,再检查 dist/assets 是否同时存在入口脚本和额外的异步 JavaScript 资源。

bash
npm run build

预期输出

text
vite v<VALUE> building for production...
...
✓ built in <TIME>

实际 Vite 版本、模块数量、文件名、哈希、体积和耗时都会不同。构建完成后,如果两个页面都仍被打进唯一的入口 JavaScript 文件,应检查是否误用了静态导入,或是否在其他模块中提前静态引用了这些页面。

避免分包后的体验回退

分包减少首屏下载量,但把成本移动到了“第一次进入页面”。高频页面可以在用户即将访问时预加载,例如菜单悬停、空闲时段或登录后根据角色预取;低频后台页面则保持真正的按需加载。

不要只追求 chunk 数量。合理目标是让首屏依赖、业务页面和共享重依赖形成清晰边界,并在真实构建产物中验证。这样页面增长时,新增模块更可能只影响自己的异步资源,而不是持续膨胀整个应用主包。

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

目录与阅读设置

阅读设置

17

记录一个想法

路由懒加载与分包

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

登录哪都通