Vue 3 中 KeepAlive 通过保留组件实例实现状态缓存,需用 包裹 ,组件须声明 name,配合 include/exclude 过滤、key 区分实例,并利用 activated/deactivated 钩子管理状态。

Vue 3 中用 KeepAlive 缓存动态切换的组件状态,核心是让组件实例不被销毁,而是保留在内存中复用。它不是“记住页面快照”,而是“留住组件实例及其所有响应式数据、DOM 状态、滚动位置、定时器、编辑内容等”。只要配置得当,切走再切回,就像从未离开过。
必须用 KeepAlive 包裹 component 标签
动态组件靠 <component :is="xxx"></component> 切换,但默认每次都会卸载旧组件、创建新实例。要缓存,就得在外层加 KeepAlive(注意 PascalCase 写法,不是小写的 keep-alive):
<keepalive><component :is="currentComponent"></component></keepalive>- 组件需显式声明
name选项,否则include/exclude无法识别 - 推荐用
shallowRef存储组件引用,避免不必要的响应式开销
按需控制哪些组件该缓存
不是所有动态组件都适合长期缓存。比如实时数据看板、带轮询的监控页,缓存反而导致数据陈旧。用 include 或 exclude 精准过滤:
- 只缓存表单和详情类:
<keepalive :include="['OrderForm', 'UserDetail']"></keepalive> - 排除实时类组件:
<keepalive :exclude="['LiveStatus', 'StockTicker']"></keepalive> - 支持正则匹配:
:include="/^(Order|Product)/"(记得加引号并用v-bind)
利用 activated/deactivated 钩子做状态衔接
被 KeepAlive 包裹的组件不再触发 mounted/unmounted,但会新增两个专属生命周期钩子:
立即学习“前端免费学习笔记(深入)”;
-
onDeactivated:组件即将隐藏时调用,适合保存草稿、暂停请求、清除定时器 -
onActivated:组件重新显示时调用,适合恢复滚动、重连 WebSocket、拉取增量更新 - 例如表单页可这样保存还原:
onDeactivated(() => localStorage.setItem('draft', JSON.stringify(form)))onActivated(() => { const d = localStorage.getItem('draft'); if (d) form.value = JSON.parse(d) })
避免同名组件互相覆盖缓存
多个 tab 共用同一个组件(如订单详情页 /order/1001 和 /order/1002),若不区分,后打开的会把前一个的状态冲掉。解决方法是给 <component></component> 加唯一 key:
<component :is="currentComponent" :key="route.fullPath"></component>- 或更精准地用业务 ID:
:key="'order-' + route.params.id" - 需要强制刷新某实例?临时改 key 值(如加时间戳),Vue 就会新建实例
不复杂但容易忽略。关键就四点:包裹正确、命名明确、过滤合理、key 唯一。


















