必须用 包裹组件才能触发 onDeactivated,它仅在组件被缓存且隐藏(非销毁)时执行;需在 中导入并调用,常见于清理定时器、取消请求、保存状态等场景。

要让 Vue 单文件组件在停用时触发 onDeactivated 钩子,核心前提是:该组件必须被 <keep-alive></keep-alive> 包裹,且处于缓存状态下的“隐藏”过程(即从 DOM 中移除但未销毁)。
必须用 包裹组件
onDeactivated 不是普通生命周期钩子,它只在 <keep-alive></keep-alive> 的上下文中生效。如果组件没被包裹,哪怕切换显示/隐藏(如用 v-if),也不会触发该钩子。
- 正确写法(父组件中):
<keep-alive> <MyComponent /> </keep-alive>
- 错误写法(无 keep-alive):
<MyComponent v-if="show" />
此时组件会销毁重建,触发的是beforeUnmount和unmounted,而非onDeactivated。
在 setup 中正确声明 onDeactivated
使用组合式 API 时,需显式导入并调用:
- 在
<script setup></script>中:import { onDeactivated } from 'vue' onDeactivated(() => { console.log('组件已停用,进入缓存') // 清理定时器、取消请求、保存表单草稿等 }) - 注意:该回调仅在组件因路由切换、
<component :is></component>切换、或条件渲染(配合<keep-alive></keep-alive>)而被“停用”时执行,不是每次v-show切换都会触发(v-show不影响组件生命周期)。
常见不触发的原因和排查点
即使写了 onDeactivated,也可能没执行——通常是因为缓存机制未生效:
立即学习“前端免费学习笔记(深入)”;
-
<keep-alive></keep-alive>没生效:检查是否被外层v-if或其它逻辑提前卸载;确保组件确实被缓存(比如在路由视图中,<router-view></router-view>需嵌套在<keep-alive></keep-alive>内) - 组件名不匹配
include:若用了<keep-alive include="Foo"></keep-alive>,请确认组件的name选项或文件导出名一致(如export default { name: 'Foo' }) - 服务端渲染(SSR)环境:onDeactivated 在 SSR 期间不会被调用,仅客户端有效
- 误用
@vnode-mounted等事件监听:这不是生命周期钩子,也不能替代onDeactivated
典型使用场景示例
停用时适合做资源释放和状态暂存:
- 清除定时器(避免内存泄漏)
- 取消未完成的 API 请求(如用 AbortController)
- 保存当前滚动位置或表单输入值到
sessionStorage或 pinia store - 暂停视频播放、停止 Canvas 动画等


















