侧边栏壁纸
博主头像
洋洋的技术笔记

行动起来,活在当下

  • 累计撰写 25 篇文章
  • 累计创建 3 个标签
  • 累计收到 0 条评论

目 录CONTENT

文章目录
VUE

组件生命周期详解

洋洋的技术笔记
2026-11-22 / 0 评论 / 0 点赞 / 3 阅读 / 0 字

组件生命周期详解

生命周期钩子描述组件从创建到卸载的关键时机。正确使用它们,重点不是背顺序,而是知道数据请求、DOM 操作、响应式更新和资源清理分别应该放在哪里。

上一篇《动态组件与异步组件》已经遇到挂载、卸载和缓存激活的区别。本文系统梳理 Vue 3 组件生命周期,并通过一个任务列表示例说明:为什么 onMounted 不适合包办所有初始化,为什么更新钩子不能随意修改状态,以及缓存组件为什么需要另一组钩子。

写作约定:示例以 Vue 3 <script setup> 为主。文中生命周期顺序以常规客户端渲染为背景;SSR、异步组件、错误处理和特殊渲染场景可能存在额外边界,应结合具体版本与运行环境验证。


一、先建立组件实例的时间线

一个普通组件可以简化为以下过程:

创建实例 → 初始化状态 → 首次渲染前 → 挂载到 DOM
       → 响应式状态变化 → 重新渲染前 → DOM 更新完成
       → 卸载前 → 清理绑定 → 卸载完成

Vue 3 组合式 API 中常用的钩子包括:

阶段

钩子

典型用途

挂载前

onBeforeMount

较少使用,注册挂载前逻辑

挂载完成

onMounted

访问 DOM、发起客户端初始化工作

更新前

onBeforeUpdate

读取 DOM 更新前状态,较少使用

更新完成

onUpdated

检查更新后的 DOM,避免无条件改状态

卸载前

onBeforeUnmount

清理仍依赖当前实例的资源

卸载完成

onUnmounted

记录卸载完成、补充清理逻辑

缓存激活

onActivated

缓存组件重新进入页面

缓存停用

onDeactivated

缓存组件被切走但未卸载

<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 组件生命周期可以归纳为四条原则:

  1. 不依赖 DOM 的状态和纯逻辑直接在 setup 中初始化。

  2. 挂载后的 DOM 操作和客户端副作用使用 onMounted,并成对清理。

  3. 更新钩子用于观察更新后的组件,不要用无条件状态修改制造循环。

  4. 普通卸载与 KeepAlive 的停用、激活是不同语义,应分别设计请求和资源管理。

理解这些时机后,生命周期钩子就不再是一组需要背诵的 API,而是组织副作用和保证资源可回收的边界。

下一篇预告

下一篇《过渡与动画效果》将介绍 Vue 的 Transition、TransitionGroup,以及列表移动和动画完成时机的处理方法。


作者:洋洋技术笔记 发布日期:2026-11-22 系列:Vue.js从入门到精通 - 第13篇


原文链接:洋洋的技术笔记

0

评论区