Vue3 组合式 API 生命周期钩子使用备忘

发布于2026-11-22 12:47 阅读12次 按实际使用顺序梳理 Vue3 组合式 API 的生命周期钩子:setup 与选项式的对应关系、onMounted 与 onUnmounted 的典型用法,并总结在 setup 顶层操作 DOM、忘记清理定时器、onUpdated 里改数据死循环、异步请求返回时组件已销毁等高频坑。
# Vue3 组合式 API 生命周期钩子使用备忘
从选项式 API 转到组合式 API 后,生命周期钩子的写法和使用时机都变了。用错时机是很多"数据拿不到""事件没清理"问题的根源。本文按实际使用顺序梳理一遍。
## 一、钩子的对应关系
组合式 API 需要从 `vue` 显式导入钩子:
| 选项式 | 组合式 |
|---|---|
| beforeCreate / created | `setup()` 本身 |
| onMounted | `onMounted()` |
| onUpdated | `onUpdated()` |
| onUnmounted | `onUnmounted()` |
`setup` 执行时机最早,相当于把 beforeCreate 和 created 合并了,此时组件实例还没挂载,拿不到 DOM。
## 二、最常用的三个
```js
import { onMounted, onUnmounted, ref } from 'vue'
const timer = ref(null)
onMounted(() => {
timer.value = setInterval(() => { /* 轮询 */ }, 1000)
})
onUnmounted(() => {
clearInterval(timer.value) // 一定要清理
})
```
- **onMounted**:DOM 挂载完成,适合发起请求、初始化图表、绑定事件
- **onUpdated**:数据更新导致 DOM 重新渲染后触发,慎用(容易死循环)
- **onUnmounted**:组件销毁,必须在这里清除定时器、事件监听、第三方实例
## 三、四个高频坑
> **坑 1:在 setup 顶层操作 DOM**
> `setup` 执行时模板还没渲染,`document.querySelector` 拿到的是 null。要等操作 DOM 的逻辑放进 `onMounted`。
> **坑 2:忘记清理定时器 / 事件监听**
> 组件销毁后 `setInterval`、`addEventListener` 还在跑,造成内存泄漏和重复执行。在 `onUnmounted`里成对清理。
> **坑 3:onUpdated 里改响应式数据**
> 在 `onUpdated` 里修改会触发再次更新,进而再次触发 `onUpdated`,形成无限循环。这里只适合读取 DOM 状态做记录。
> **坑 4:异步请求返回时组件已销毁**
> 请求发出后用户切走了页面,回来时赋值到一个已卸载的组件上,虽然不报错但可能引发意外行为。可以用一个标志位配合 `onUnmounted` 取消。
## 四、执行时机速记
记住一句话:**setup 建数据,mounted 碰 DOM,unmounted 做清理**。绝大多数场景按这个原则放代码,就不会踩时机的坑。父子组件的钩子顺序是父 setup → 子 setup → 子 mounted → 父 mounted,调试时留意这个顺序能省很多时间。