组件生命周期详解
生命周期钩子描述组件从创建到卸载的关键时机。正确使用它们,重点不是背顺序,而是知道数据请求、DOM 操作、响应式更新和资源清理分别应该放在哪里。
上一篇《动态组件与异步组件》已经遇到挂载、卸载和缓存激活的区别。本文系统梳理 Vue 3 组件生命周期,并通过一个任务列表示例说明:为什么 onMounted 不适合包办所有初始化,为什么更新钩子不能随意修改状态,以及缓存组件为什么需要另一组钩子。
写作约定:示例以 Vue 3
<script setup>为主。文中生命周期顺序以常规客户端渲染为背景;SSR、异步组件、错误处理和特殊渲染场景可能存在额外边界,应结合具体版本与运行环境验证。
一、先建立组件实例的时间线
一个普通组件可以简化为以下过程:
创建实例 → 初始化状态 → 首次渲染前 → 挂载到 DOM
→ 响应式状态变化 → 重新渲染前 → DOM 更新完成
→ 卸载前 → 清理绑定 → 卸载完成Vue 3 组合式 API 中常用的钩子包括:
<script setup> 顶层的 ref、computed、函数声明等代码在组件初始化时执行,不需要专门包进 onBeforeMount。
二、setup 阶段:建立响应式状态与纯逻辑
下面是一个任务计数组件的起点:
<script setup>
import { computed, ref } from 'vue'
const tasks = ref([
{ id: 1, title: '整理需求', done: true },
{ id: 2, title: '编写示例', done: false }
])
const remaining = computed(() => tasks.value.filter(task => !task.done).length)
function toggleTask(id) {
const task = tasks.value.find(item => item.id === id)
if (task) task.done = !task.done
}
</script>
<template>
<p>剩余任务:{{ remaining }}</p>
<button type="button" @click="toggleTask(2)">切换任务状态</button>
</template>初始化数组、定义计算属性和事件处理函数都不依赖真实 DOM,可以直接执行。这样逻辑在首次渲染前已经准备好,模板第一次计算就能得到结果。
onBeforeMount 并不能让普通状态初始化变得“更标准”。把不依赖 DOM 的代码全部延迟到挂载前,只会增加不必要的嵌套,并可能让首次渲染缺少数据。
三、onMounted:何时访问 DOM 与发起请求
onMounted 在组件完成初始 DOM 挂载后执行。适合以下场景:
读取元素尺寸、位置或焦点;
初始化必须操作 DOM 的第三方库;
发起只发生在客户端的数据请求;
注册后续需要清理的浏览器事件监听。
<script setup>
import { onBeforeUnmount, onMounted, ref } from 'vue'
const listElement = ref(null)
const online = ref(window.navigator.onLine)
function updateOnlineStatus() {
online.value = window.navigator.onLine
}
onMounted(() => {
listElement.value?.focus()
window.addEventListener('online', updateOnlineStatus)
window.addEventListener('offline', updateOnlineStatus)
})
onBeforeUnmount(() => {
window.removeEventListener('online', updateOnlineStatus)
window.removeEventListener('offline', updateOnlineStatus)
})
</script>
<template>
<p>{{ online ? '在线' : '离线' }}</p>
<ul ref="listElement" tabindex="-1">
<li>任务 A</li>
</ul>
</template>模板中的 ref="listElement" 会填充同名引用。挂载前它是 null,挂载后才能访问元素。
如果 SSR 也执行这段初始化,顶层直接读取 window 会产生问题。需要服务端渲染时,应把浏览器 API 访问限制在客户端钩子中,并处理服务端与客户端首屏一致性。
数据请求并非必须在 onMounted 中发起,但常见客户端页面会在此时加载。不要把请求逻辑写成永不清理的异步操作:组件卸载后,结果仍可能返回并触发无意义更新。
四、异步请求要处理卸载与响应乱序
下面以任务查询为例,同时处理加载状态、请求取消和过期响应:
<script setup>
import { onBeforeUnmount, ref, watch } from 'vue'
const props = defineProps({
keyword: { type: String, default: '' }
})
const tasks = ref([])
const loading = ref(false)
let controller = null
async function loadTasks(keyword) {
controller?.abort()
const currentController = new AbortController()
controller = currentController
loading.value = true
try {
const params = new URLSearchParams({ keyword })
const response = await fetch(`/api/tasks?${params}`, {
signal: currentController.signal
})
if (!response.ok) throw new Error(`HTTP ${response.status}`)
tasks.value = await response.json()
} catch (error) {
if (error.name !== 'AbortError') throw error
} finally {
if (controller === currentController) {
controller = null
loading.value = false
}
}
}
watch(() => props.keyword, loadTasks, { immediate: true })
onBeforeUnmount(() => controller?.abort())
</script>
<template>
<p v-if="loading">加载中...</p>
<ul v-else>
<li v-for="task in tasks" :key="task.id">{{ task.title }}</li>
</ul>
</template>watch 的 immediate: true 会在初始化时执行回调,因此这里不必再写一个重复的 onMounted 请求。新关键字到来时先取消旧请求,避免较慢的旧响应覆盖新结果。
实际项目还应在页面中展示非取消错误,并根据接口封装处理认证、超时和错误提示。上面的 throw error 只保留了最小示例,不是完整交互方案。
五、更新钩子:DOM 已更新,不等于可以无限更新
当组件使用的响应式状态变化并触发重新渲染时,会经过 onBeforeUpdate 和 onUpdated。
<script setup>
import { nextTick, onUpdated, ref } from 'vue'
const count = ref(0)
const history = ref([])
onUpdated(() => {
console.log('组件 DOM 已完成一次更新')
})
async function increase() {
count.value += 1
await nextTick()
history.value.push(`count 已变为 ${count.value}`)
}
</script>
<template>
<button type="button" @click="increase">计数:{{ count }}</button>
</template>onUpdated 会在组件自身更新后触发,但不要无条件下面的代码:
// 不推荐:更新后再次修改渲染依赖,可能形成持续更新
onUpdated(() => {
count.value += 1
})大多数派生数据应该使用 computed,状态响应关系可以使用 watch。只有确实需要检查更新后 DOM 时,才考虑 onUpdated。
nextTick 与 onUpdated 也不是同一个概念:前者等待当前这一轮 DOM 更新后继续执行代码,后者是组件更新生命周期钩子。事件处理后需要读取新 DOM 时,通常优先使用 nextTick,而不是把逻辑塞进全局更新钩子。
父组件状态变化还可能同时更新多个子组件,不能把某个子组件的 onUpdated 当成整个页面所有异步操作的完成通知。
六、卸载钩子:清理 setup 中创建的外部资源
组件卸载后,Vue 会处理自身模板和响应式绑定,但不会自动清理所有外部副作用。常见需要清理的资源包括:
window、document上手动添加的事件监听;setInterval、未清除的定时任务;WebSocket、第三方编辑器、图表和地图实例;
手动创建的 DOM 观察器与订阅;
尚未完成且不再需要的网络请求。
<script setup>
import { onBeforeUnmount, onMounted, ref } from 'vue'
const now = ref(new Date())
let timer
onMounted(() => {
timer = window.setInterval(() => {
now.value = new Date()
}, 1000)
})
onBeforeUnmount(() => {
window.clearInterval(timer)
})
</script>
<template>
<time>{{ now.toLocaleTimeString() }}</time>
</template>onBeforeUnmount 与 onUnmounted 都能见到清理代码。若清理过程仍需要访问组件实例、DOM 或正在使用的第三方对象,通常在卸载前处理更直观;关键是创建与销毁必须成对,并覆盖初始化失败等分支。
对于 watch 创建的副作用,可以在回调中使用 onCleanup,让每次重新执行和停止监听时都能清理旧资源,不必把所有逻辑集中到卸载钩子。
七、KeepAlive:停用不是卸载,激活不等于首次挂载
被 <KeepAlive> 缓存的组件切走时不会按普通流程卸载,切回时也不会重新创建实例。因此,仅使用 onMounted 和 onBeforeUnmount 无法表达“每次进入”和“每次离开”。
<script setup>
import { onActivated, onDeactivated, ref } from 'vue'
const refreshedAt = ref('')
async function refresh() {
refreshedAt.value = new Date().toLocaleTimeString()
}
onActivated(refresh)
onDeactivated(() => {
console.log('面板暂时停用,实例仍被缓存')
})
</script>
<template>
<p>最近刷新:{{ refreshedAt }}</p>
</template>缓存组件首次挂载时也会执行 onActivated,因此示例只保留这一处刷新入口。若同时在 onMounted 和 onActivated 中请求同一个接口,首次进入就可能重复请求;如果两者承担不同职责,也应通过状态明确区分。
缓存组件离开后,定时器是否继续运行、请求是否取消、数据是否刷新,都应由产品需求决定。若面板离开时不需要工作,就在 onDeactivated 中暂停或清理,在 onActivated 中恢复。
退出登录或切换账号时,还要考虑缓存中是否残留上一个用户的数据。必要时重置缓存边界,而不是把 KeepAlive 当作永久状态仓库。
八、父子组件钩子的相对顺序
常规同步组件首次挂载时,子组件完成挂载后,父组件的 onMounted 才执行。因此父组件可以在自己的挂载钩子中依赖已经完成挂载的子组件 DOM。
卸载时,父组件进入卸载前钩子后,子组件也会执行对应清理流程。不要仅凭控制台日志推导所有复杂场景的绝对顺序;异步组件、Teleport、KeepAlive 和条件渲染会改变具体结构。
如果需要协调父子逻辑,优先通过 Props、事件和明确的状态管理,不要让父组件依赖子组件在某一刻“恰好执行过某段代码”。DOM 测量等确有时序要求的操作,再通过 ref、暴露方法和 nextTick 建立清晰契约。
九、常见误用与修正
1. 把所有代码放进 onMounted
纯状态与计算属性应在 setup 中建立。只有依赖挂载结果或客户端环境的工作才需要延迟。
2. 在 onUpdated 中无条件修改响应式状态
这可能再次触发更新。派生值改用 computed,响应特定变化使用带明确依赖的 watch。
3. 忘记清理全局事件与定时器
每次组件挂载都可能新增监听器,重复进入页面后造成重复执行和内存增长。注册与清理必须成对。
4. 同时用 immediate watch 和 onMounted 请求同一数据
这通常会重复请求。选择一种入口,并验证首次加载、参数变化、停用和卸载行为。
5. 把 KeepAlive 停用当成卸载
缓存实例没有销毁,需要恢复和暂停的工作应使用 onActivated、onDeactivated。
6. 在卸载后仍处理旧请求结果
使用 AbortController、请求序号或其他失效机制,防止过期响应覆盖当前状态。取消网络请求只是手段之一,还要检查业务库是否真正支持取消。
十、如何验证生命周期逻辑
生命周期问题不能只靠肉眼观察控制台。建议通过组件测试覆盖真实行为:
挂载后是否注册监听、访问正确 DOM 或发起一次请求;
Props 变化后是否只加载新条件对应的数据;
卸载后定时器、事件和订阅是否停止;
KeepAlive切换时是否按预期刷新、暂停或保留状态;同一操作重复多次后,是否出现重复请求和重复监听。
测试断言应观察行为,例如渲染文本、请求次数、定时器执行次数和清理函数调用,而不是仅断言某个内部钩子“被调用”。如果测试全部 Mock 掉 Vue 挂载过程,就无法证明真实生命周期正确。
十一、总结
Vue 组件生命周期可以归纳为四条原则:
不依赖 DOM 的状态和纯逻辑直接在 setup 中初始化。
挂载后的 DOM 操作和客户端副作用使用
onMounted,并成对清理。更新钩子用于观察更新后的组件,不要用无条件状态修改制造循环。
普通卸载与 KeepAlive 的停用、激活是不同语义,应分别设计请求和资源管理。
理解这些时机后,生命周期钩子就不再是一组需要背诵的 API,而是组织副作用和保证资源可回收的边界。
下一篇预告
下一篇《过渡与动画效果》将介绍 Vue 的 Transition、TransitionGroup,以及列表移动和动画完成时机的处理方法。
作者:洋洋技术笔记 发布日期:2026-11-22 系列:Vue.js从入门到精通 - 第13篇
原文链接:洋洋的技术笔记
评论区