Vue路由懒加载与组件懒加载示例详解

 更新时间:2026年03月11日 08:54:17   作者:发现一只大呆瓜  
懒加载也称为延迟加载,是一种将资源(如图片、组件、代码等)推迟到需要的时候再加载的策略,这篇文章主要介绍了Vue路由懒加载与组件懒加载的相关资料,文中通过代码介绍的非常详细,需要的朋友可以参考下

前言

在构建大型单页应用(SPA)时,JavaScript 包体积(Bundle Size)往往会随着业务增长而膨胀,导致首屏加载缓慢、白屏时间长。懒加载(Lazy Loading) 是解决这一问题的核心方案。其本质是将代码分割成多个小的 chunk,仅在需要时才从服务器下载。

一、 路由懒加载:按需拆分页面

1. 为什么需要路由懒加载?

如果不使用懒加载,所有路由对应的组件都会被打包进同一个 app.js 中。用户访问首页时,浏览器不得不下载整个应用的逻辑,造成严重的性能浪费。

2. 实现方式:ESimport()

利用动态导入语法,打包工具(如 Vite 或 Webpack)会自动进行 代码分割(Code Splitting)

// router/index.ts
import { createRouter, createWebHistory, RouteRecordRaw } from 'vue-router';

// 静态导入:会随着主包一起加载,适合首页
import Home from '@/views/Home.vue';

const routes: Array<RouteRecordRaw> = [
  {
    path: '/',
    name: 'Home',
    component: Home
  },
  {
    path: '/about',
    name: 'About',
    // 动态导入:只有访问 /about 路径时,浏览器才会请求该组件对应的 JS 文件
    component: () => import('@/views/About.vue')
  }
];

const router = createRouter({
  history: createWebHistory(),
  routes
});

export default router;

二、 组件懒加载:细粒度控制

有些组件(如弹窗、复杂的图表、第三方重型库)并不需要在页面初次渲染时立即存在。

1. Vue 3 的defineAsyncComponent

在 Vue 3 中,异步组件必须使用 defineAsyncComponent 进行显式声明。

示例

<template>
  <div>
    <h1>主页面</h1>
    <button @click="showChart = true">加载并显示报表</button>
    
    <AsyncChart v-if="showChart" />
  </div>
</template>

<script setup lang="ts">
import { ref, defineAsyncComponent } from 'vue';

const showChart = ref<boolean>(false);

// 显式定义异步组件
const AsyncChart = defineAsyncComponent(() =>
  import('@/components/BigChart.vue')
);

// 高级配置(可选):带加载状态
const AsyncComponentWithConfig = defineAsyncComponent({
  loader: () => import('./components/MyComponent.vue'),
  loadingComponent: LoadingComponent, // 加载过程中显示的组件
  errorComponent: ErrorComponent,     // 加载失败时显示的组件
  delay: 200,                         // 展示加载组件前的延迟时间
  timeout: 3000                       // 超时时间
});
</script>

2. Vue 2 中直接使用import函数声明异步组件

export default {
  components: {
    // 定义一个异步组件
    'MyLazyComponent': () => import('./components/MyLazyComponent.vue')
  }
}

三、 底层原理与分包策略

1. 打包工具的配合

当你使用 import() 时:

  • Vite/Rollup:会自动将该组件及其依赖提取到一个独立的 .js 文件中。

  • Webpack:会生成一个 chunk,你可以通过“魔法注释”自定义 chunk 的名称:

    const About = () => import(/* webpackChunkName: "about-group" */ './About.vue')
    

四、 总结

  1. 首屏优化:建议首页(Home)使用静态导入,而其他非核心路径、非首屏展示的弹窗/插件全部使用懒加载。

  2. 用户体验:使用异步组件时,建议配合 loadingComponent,避免加载过程中组件区域出现突兀的空白 。

到此这篇关于Vue路由懒加载与组件懒加载的文章就介绍到这了,更多相关Vue路由与组件懒加载内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • vue可用于拖动排序组件示例

    vue可用于拖动排序组件示例

    这篇文章主要为大家介绍了vue可用于拖动排序组件示例详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-06-06
  • vue路由跳转时判断用户是否登录功能的实现

    vue路由跳转时判断用户是否登录功能的实现

    下面小编就为大家带来一篇vue路由跳转时判断用户是否登录功能的实现。小编觉得挺不错的,现在就分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-10-10
  • Vue组件教程之Toast(Vue.extend 方式)详解

    Vue组件教程之Toast(Vue.extend 方式)详解

    这篇文章主要给大家介绍了关于Vue组件教程之Toast(Vue.extend 方式)的相关资料,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2019-01-01
  • vue项目实现图片上传功能

    vue项目实现图片上传功能

    这篇文章主要为大家详细介绍了vue项目实现图片上传功能,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2019-12-12
  • Vue lazyload图片懒加载实例详解

    Vue lazyload图片懒加载实例详解

    本文通过实例代码给大家介绍了Vue lazyload图片懒加载的相关知识,通过导入配置等操作src/main.jswenj ,代码简单易懂,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧
    2021-12-12
  • vue长列表优化之虚拟列表实现过程详解

    vue长列表优化之虚拟列表实现过程详解

    前端的业务开发中会遇到不使用分页方式来加载长列表的需求,下面这篇文章主要给大家介绍了关于vue长列表优化之虚拟列表实现的相关资料,文中通过实例代码介绍的非常详细,需要的朋友可以参考下
    2022-08-08
  • vue原生方法自定义右键菜单

    vue原生方法自定义右键菜单

    这篇文章主要为大家详细介绍了vue原生方法自定义右键菜单,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2022-04-04
  • Vue3渲染器与渲染函数的用法详解

    Vue3渲染器与渲染函数的用法详解

    Vue3渲染器将虚拟DOM转为真实DOM,支持高效更新与跨平台;渲染函数(h())替代JSX,更灵活,与CompositionAPI结合可优化性能,提升复杂场景下的开发效率与应用性能
    2025-08-08
  • Vue关键字搜索功能实战小案例

    Vue关键字搜索功能实战小案例

    在vue项目中,搜索功能是我们经常需要使用的一个场景,下面这篇文章主要给大家介绍了关于Vue关键字搜索功能的相关资料,文中通过实例代码介绍的非常详细,需要的朋友可以参考下
    2023-06-06
  • Vue前端开发之实现交错过渡动画效果

    Vue前端开发之实现交错过渡动画效果

    这篇文章主要为大家详细介绍了如何通过Vue实现交错过渡动画效果,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下
    2024-11-11

最新评论