Vue / 系统课时
路由懒加载与分包
路由懒加载与分包
路由懒加载解决的是首屏一次下载过多页面代码的问题。把页面组件改成动态导入后,构建工具会沿着 import() 建立异步边界;本课再进一步说明怎样让边界稳定、共享依赖不过度重复,并用生产构建验证结果。
学习目标
- 用 Vue Router 的动态导入实现页面级懒加载
- 判断页面 chunk、主包与共享依赖之间的边界
- 用生产构建结果验证分包是否真正生效
让路由组件成为异步边界
在 Vue Router 中,路由记录的 component 可以直接写成返回动态 import() 的函数。导航发生前,页面模块不会执行;首次进入对应路由时,浏览器才请求该异步模块。公共布局可以继续静态导入,让导航骨架保持稳定。
下面的示例假设项目已有 AppLayout.vue、DashboardView.vue 和订单页面文件,可直接作为 src/router/index.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 资源。
npm run build预期输出
vite v<VALUE> building for production...
...
✓ built in <TIME>实际 Vite 版本、模块数量、文件名、哈希、体积和耗时都会不同。构建完成后,如果两个页面都仍被打进唯一的入口 JavaScript 文件,应检查是否误用了静态导入,或是否在其他模块中提前静态引用了这些页面。
避免分包后的体验回退
分包减少首屏下载量,但把成本移动到了“第一次进入页面”。高频页面可以在用户即将访问时预加载,例如菜单悬停、空闲时段或登录后根据角色预取;低频后台页面则保持真正的按需加载。
不要只追求 chunk 数量。合理目标是让首屏依赖、业务页面和共享重依赖形成清晰边界,并在真实构建产物中验证。这样页面增长时,新增模块更可能只影响自己的异步资源,而不是持续膨胀整个应用主包。