Vue / 系统课时
生命周期与资源清理
生命周期与资源清理
组件中的定时器、事件监听、订阅和第三方对象都有明确的创建与释放时机。本课用 Vue 3 生命周期钩子建立资源所有权边界,确保组件反复挂载和卸载时不会留下重复监听、后台任务或失效引用。
学习目标
- 根据资源依赖的 DOM 状态选择合适的生命周期钩子
- 为定时器、事件监听和外部订阅设计成对清理逻辑
- 区分组件生命周期清理与组合式函数中的作用域清理
生命周期就是资源所有权边界
setup 阶段适合创建响应式状态和不依赖真实 DOM 的逻辑;onMounted 表示组件 DOM 已经挂载,可以安全访问浏览器元素、创建观察器或连接依赖页面节点的第三方实例。组件状态变化后可能多次触发 onUpdated,因此这里不适合无条件创建长期资源,否则每次更新都可能再注册一份。
组件开始卸载后,应停止所有由它拥有的副作用。通常在 onUnmounted 中清理定时器、事件监听、WebSocket、观察器和第三方实例。核心判断不是“哪个钩子最常用”,而是谁创建资源、谁负责释放资源。

管理定时器与浏览器事件
下面的组件在挂载后读取窗口宽度、注册 resize 监听并启动定时器;卸载时执行完全对称的清理。onUpdated 只观察更新,不创建新的长期资源。
<script setup lang="ts">
import { onMounted, onUnmounted, onUpdated, ref } from 'vue'
const elapsedSeconds = ref(0)
const windowWidth = ref(0)
let timerId: number | undefined
function syncWindowWidth(): void {
windowWidth.value = window.innerWidth
}
onMounted(() => {
// DOM 和 window 已可用,此时建立组件拥有的浏览器资源。
syncWindowWidth()
window.addEventListener('resize', syncWindowWidth)
timerId = window.setInterval(() => {
elapsedSeconds.value += 1
}, 1000)
})
onUpdated(() => {
// 更新钩子可能执行很多次,只观察状态,不重复注册资源。
console.debug('component updated', elapsedSeconds.value, windowWidth.value)
})
onUnmounted(() => {
// 清理操作与创建操作保持一一对应。
window.removeEventListener('resize', syncWindowWidth)
if (timerId !== undefined) {
window.clearInterval(timerId)
timerId = undefined
}
})
</script>
<template>
<p>运行时间:{{ elapsedSeconds }} 秒</p>
<p>窗口宽度:{{ windowWidth }} px</p>
</template>预期结果
页面挂载后显示当前窗口宽度,运行时间每秒递增。
调整浏览器宽度时,窗口宽度随之更新。
组件卸载后,resize 监听和定时器停止,不再产生后续更新。
控制台更新日志中的数字属于动态值,可视为 component updated <VALUE> <VALUE>。这里没有把 window.innerWidth 放到模块初始化或挂载前读取,因此也更容易适配服务端渲染环境。真正依赖浏览器 API 的代码被限制在挂载后的生命周期内。
让清理逻辑保持成对和幂等
长期资源最容易出问题的地方是“创建成功了,但某条退出路径没有释放”。工程中可以把资源按成对操作检查:setInterval 对应 clearInterval,addEventListener 对应 removeEventListener,订阅函数对应取消订阅函数,第三方实例的 create 对应 destroy 或 dispose。
清理逻辑还应尽量幂等,也就是即使防御性地执行多次也不会抛出异常。常见做法是在释放后把实例引用设为 undefined 或 null,并在调用清理方法前检查资源是否存在。
组合式函数也要承担清理责任
如果资源逻辑被封装进 composable,就不应该要求使用者记住它内部创建过哪些副作用。同步创建的 Vue watch、watchEffect 会归属当前响应式作用域并在作用域停止时结束;自己创建的浏览器事件、订阅和外部实例则仍然需要显式释放。
在组件专用 composable 中可以使用 onUnmounted,而需要适配组件作用域、嵌套 effectScope 等场景时,onScopeDispose 更能表达“资源跟随当前作用域销毁”的含义。这样组件只负责调用 composable,资源所有权仍封装在创建资源的那一层。
判断是否需要清理时,可以问一个简单问题:组件已经从页面消失后,这段逻辑是否还能继续运行、持有 DOM 或接收外部事件?如果答案是能,就应当给它设计明确的释放路径。