onBeforeUnmount 是组件卸载前执行清理逻辑的关键时机,适合清除定时器、全局事件监听、WebSocket 连接等副作用;需用 ref 管理句柄并在其中安全清除,避免内存泄漏。

onBeforeUnmount 是组件卸载前执行清理逻辑的**关键时机**,此时组件实例仍完整、响应式数据可读写、DOM 尚未移除,适合安全地关闭副作用。
核心使用场景
主要用于清除那些独立于组件生命周期运行、但会访问组件状态的异步资源:
- 定时器(setInterval / setTimeout)
- 全局事件监听(window.addEventListener)
- WebSocket 或 EventSource 连接
- 第三方库实例(如地图、图表的 destroy 方法)
- 手动添加的 DOM 事件(如 document 级 click 监听)
标准写法:配合 ref 管理资源 ID
避免用闭包或普通变量存储 timer、listener 等句柄——必须让 onBeforeUnmount 能访问到它们:
- 用 ref(null) 声明一个响应式容器,存定时器 ID、事件监听函数引用或连接对象
- 在 onMounted 或触发逻辑中赋值(例如
timer.value = setInterval(...)) - 在 onBeforeUnmount 中检查并清除(
clearInterval(timer.value)、removeEventListener等) - 清除后可选设为
null,便于后续判断状态
常见错误要避开
这些做法容易引发报错或内存泄漏:
立即学习“前端免费学习笔记(深入)”;
- 把定时器直接写在 setup 顶层 —— 组件还没挂载就启动,且无法绑定生命周期
- 只在 onUnmounted 清理 —— 此时响应式系统已解绑,
ref.value可能为 undefined,调用emit或更新状态会静默失败或报错 - 用普通变量(如
let timer)保存句柄 —— onBeforeUnmount 作用域内不可访问 - 忘记检查句柄是否存在就直接清除(虽
clearInterval安全,但removeEventListener必须传入原函数引用,否则无效)
进阶建议:封装成可复用 Hook
业务中频繁用到定时器、监听等,推荐封装为自定义 Hook(如 useInterval 或 useEventListener):
- 内部自动用 ref 管理句柄
- 内部调用 onBeforeUnmount 完成清理
- 对外暴露
pause、resume、clear等控制方法 - 组件调用时无需关心清理细节,专注业务逻辑


















