完整教程：Vue 3 官方 Hooks 的用法与实现原理

Vue 3 引入了 Composition API，使得生命周期钩子（hooks）在函数式风格中更清晰地表达。本篇文章将从官方 hooks 的使用、实现原理以及自定义 hooks 的结构化思路出发，全面理解 Vue 3 的 hooks 系统。

---

1. Vue 3 官方生命周期 hooks 一览

Hook 函数	触发时机
onBeforeMount	组件挂载前
onMounted	组件挂载后
onBeforeUpdate	数据变更、视图更新前
onUpdated	数据变更、视图更新后
onBeforeUnmount	卸载前
onUnmounted	卸载后
onActivated	<KeepAlive> 激活时
onDeactivated	<KeepAlive> 失活时
onErrorCaptured	错误捕获
onRenderTracked	响应式依赖追踪
onRenderTriggered	响应式依赖触发更新

---

✅ 2. 使用示例

<script setup>
import {
onMounted
}
from 'vue'
onMounted((
) =>
{
console.log('组件已挂载完成'
)
}
)
<
/script>

在 <script setup> 中调用 hooks 更简洁，无需访问 setup() 返回对象。

---

3. 实现原理解析

生命周期 hooks 的注册基于当前组件实例 currentInstance：

export
function onMounted(hook: Function
, target = currentInstance) {
return injectHook('mounted'
, hook, target)
}

核心函数 injectHook：

function injectHook(type: LifecycleHooks, hook: Function
, target) {
const hooks = target[type] || (target[type] = []
)
hooks.push(hook)
}

当组件进入对应生命周期阶段时，Vue 内部会遍历执行挂载在实例上的所有该类型 hook。

---

♻️ 4. 自定义 Hooks（组合逻辑复用）

Vue 3 鼓励将逻辑拆分为 useXxx 函数，以便跨组件复用。

示例：useWindowSize

// useWindowSize.ts
import {
ref, onMounted, onUnmounted
}
from 'vue'
export
function useWindowSize(
) {
const width = ref(window.innerWidth)
const height = ref(window.innerHeight)
const update = (
) =>
{
width.value = window.innerWidth
height.value = window.innerHeight
}
onMounted((
) => window.addEventListener('resize'
, update)
)
onUnmounted((
) => window.removeEventListener('resize'
, update)
)
return {
width, height
}
}

使用方式：

<script setup>
import {
useWindowSize
}
from '@/hooks/useWindowSize'
const {
width, height
} = useWindowSize(
)
<
/script>

---

自定义 hooks 的原理

• 本质是普通函数，内部调用 Vue 组合式 API（如 ref, watch, onMounted）
• 在组件 setup() 时执行，响应式变量挂接到当前组件上下文
• 内部调用生命周期钩子时会依赖当前的 getCurrentInstance()

---

5. 总结对比

类型	示例	作用	特点
官方生命周期 Hook	onMounted()	注册生命周期回调	由 Vue 内部调度
自定义 Hook	useMousePosition()	封装响应式状态 + 逻辑复用	是普通函数，可组合嵌套

---

推荐阅读

• Vue 3 官方生命周期 API
• Vue 核心源码 Lifecycle 实现
• VueUse - 高质量 Hooks 集合

---

✍️ 结语

生命周期 hooks 是 Vue 3 中非常核心的机制之一。理解它们的用法与实现，有助于我们编写结构清晰、逻辑可复用的组件。

如果你对 Vue 源码感兴趣，不妨进一步探索 Vue 是如何依赖 currentInstance 来处理作用域钩子的注册和调用的。