Vue Router 路由懒加载通过 import() 动态导入实现,使组件按需加载以减小首屏体积、提升加载速度;支持 webpackChunkName 命名、嵌套路由与命名视图懒加载,并需用 defineAsyncComponent 或 suspense 处理异步状态。

Vue Router 的路由懒加载通过动态导入(import())实现,让组件只在对应路由被访问时才加载,避免首屏打包体积过大,从而显著提升初始加载速度。
使用 import() 语法替代直接引入
传统写法会把所有路由组件同步打包进主包,导致首屏资源臃肿。改用函数式动态导入,Webpack 或 Vite 会自动将其拆分为独立 chunk。
- 错误写法(同步引入,无懒加载):
component: Home - 正确写法(动态导入,触发代码分割):
component: () => import('@/views/Home.vue')
配合 WebpackChunkName 注释优化 chunk 命名
默认生成的 chunk 名是数字(如 123.js),不利于调试和缓存管理。添加 /* webpackChunkName: "home" */ 注释可自定义名称。
- 示例:
component: () => import(/* webpackChunkName: "home" */ '@/views/Home.vue') - Vite 用户可用
/* webpackPrefetch: true */或/* webpackPreload: true */进一步控制预加载策略
对嵌套路由和命名视图也支持懒加载
子路由、children 数组中的每个路由项,以及 components 对象里的命名视图(如 default、sidebar)均可单独懒加载。
立即学习“前端免费学习笔记(深入)”;
- 子路由示例:
{ path: 'user', component: () => import('@/views/UserLayout.vue'), children: [ { path: '', component: () => import('@/views/UserList.vue') } ] } - 命名视图示例:
components: { default: () => import('@/views/Post.vue'), sidebar: () => import('@/components/PostSidebar.vue') }
注意异步组件的 loading 与 error 状态处理
懒加载组件本质是 Promise,可能处于加载、成功或失败状态。建议在路由组件中配合 <suspense></suspense>(Vue 3)或使用 defineAsyncComponent 手动封装加载态。
- Vue 3 推荐方式:
const AsyncHome = defineAsyncComponent(() => import('@/views/Home.vue')) - 搭配
<suspense></suspense>可统一处理 loading 和 error:<suspense fallback="loading..."><async-home></async-home></suspense>



















