Suspense 通过 defineAsyncComponent 动态导入实现异步加载等待,仅识别 #default 和 #fallback 插槽内直接子组件;支持 async setup 和骨架屏 fallback,避免布局跳动。

Suspense 在 Vue 单文件组件(SFC)中处理异步加载等待,核心是用声明式插槽替代手动状态管理。它不写逻辑、不改数据,只靠结构和规则就能让加载过程自动协调。
必须用 defineAsyncComponent 动态导入组件
静态 import 的组件会阻塞整个 SFC 解析,Suspense 无法捕获异步边界。只有通过 defineAsyncComponent 包裹的导入,才被 Vue 视为“可挂起”的异步组件:
- ✅ 正确写法:
const Child = defineAsyncComponent(() => import('./Child.vue')) - ❌ 错误写法:
import Child from './Child.vue'(同步引入,Suspense 完全不生效) - 可加 loading timeout:
defineAsyncComponent({ loader: () => import(...), timeout: 5000 })
template 中严格按插槽规则组织结构
Suspense 不识别普通子元素,只响应显式声明的 #default 和 #fallback 插槽,且异步组件必须是 #default 的直接子级:
支持 async setup,但需注意触发时机
子组件内部若使用 async setup()(例如顶层 await API 请求),也会被 Suspense 捕获为异步依赖:
- 子组件中写
const data = await api.getUsers(),父组件用 Suspense 包裹它,就会显示 fallback - ⚠️ 注意:不要在根组件或布局组件的 setup 里顶层 await,否则整个页面卡住,Suspense 无法介入
- 推荐组合:async setup + defineAsyncComponent,实现组件加载 + 数据获取双重等待
配合骨架屏提升体验
fallback 插槽不只能放文字提示,更适合放结构一致的骨架屏,避免布局跳动:
- 用 div 模拟标题、卡片、列表高度和间距,填充浅灰背景
- 加简单动画:
background: linear-gradient(90deg, #f0f0f0 25%, #e0e0e0 50%, #f0f0f0 75%)+background-size: 200% 100% - 保持与真实内容相同的 DOM 层级和 class,切换时无重排
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











