defineAsyncComponent 用于按需加载组件，减少首屏体积，支持加载中、失败状态控制；本质是包装异步工厂函数，基础用法为 defineAsyncComponent(() => import('./comp.vue'))，可配置 loading/error 组件、delay、timeout 等，并推荐与 Suspense 结合使用。
Vue 3 的 defineAsyncComponent 用于按需加载组件，减少首屏体积，同时支持加载中、加载失败等状态控制。它本质是把一个异步工厂函数包装成可被 Vue 识别的组件，不是直接 import 组件本身。
基础用法：最简异步加载
只需传入一个返回 Promise 的函数（通常用 import() 动态导入）：
import { defineAsyncComponent } from 'vue'
const AsyncModal = defineAsyncComponent(() =>
import('./components/Modal.vue')
)
然后像普通组件一样在模板中使用：<AsyncModal />。Vue 会在首次渲染时自动触发加载。
处理加载与错误状态
通过配置对象，可以指定 loading 和 error 组件，并控制超时和重试逻辑：
vue-component-analyzer
下载
递归分析 Vue 项目组件依赖，从入口文件生成组件层级图，支持 Vue 2/3，输出组件名、文件路径和属性。适用于分析组件结构、排查依赖或了解项目架构。
立即学习“前端免费学习笔记（深入）”；
const AsyncChart = defineAsyncComponent({
loader: () => import('./components/Chart.vue'),
loadingComponent: LoadingSpinner, // 加载中显示的组件
errorComponent: ErrorFallback, // 加载失败显示的组件
delay: 200, // 延迟 200ms 才显示 loading（防闪动）
timeout: 5000, // 超时时间，超时后触发 errorComponent
suspensible: false, // 设为 false 可禁用 Suspense（推荐显式控制）
})
-
loadingComponent和errorComponent必须是已定义的组件（可为defineComponent或 SFC） -
delay是常用优化：短时间加载完成就不显示 loading，提升体验 -
timeout需配合errorComponent才生效；若不设 errorComponent，超时也不会展示错误态
配合 Suspense 使用（推荐组合）
虽然 defineAsyncComponent 自带 loading/error 配置，但更灵活的方式是配合顶层 <Suspense>：
<template>
<Suspense>
<template #default>
<AsyncDashboard />
</template>
<template #fallback>
<LoadingSkeleton />
</template>
</Suspense>
</template>
此时组件内部无需再配 loadingComponent，所有异步依赖（包括嵌套的异步子组件）都由 Suspense 统一接管。出错时可监听 @error 事件做上报：
<Suspense @error="handleSuspenseError"> ... </Suspense>
常见问题与注意点
- 动态路径不能写死变量：
import(`./pages/${page}.vue`)在构建时会被 Webpack/Vite 当作魔法注释处理，需确保路径可静态分析，否则会报错或降级为全量加载 - 服务端渲染（SSR）中，
defineAsyncComponent仍有效，但loadingComponent和errorComponent不会在服务端渲染，仅客户端生效 - 不要在
setup()中直接调用defineAsyncComponent—— 它必须在模块顶层或export default配置中定义，否则无法被正确解析 - 如果组件导出的是命名导出（如
export const MyWidget），需用.then(module => module.MyWidget)解构，不能只靠默认导出
