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. 使用示例

ts 复制代码

<script setup>
import { onMounted } from 'vue'

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

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

🧠 3. 实现原理解析

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

ts 复制代码

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

核心函数 injectHook：

ts 复制代码

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

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

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

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

🎯 示例：useWindowSize

ts 复制代码

// 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 }
}

使用方式：

ts 复制代码

<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()`	封装响应式状态 + 逻辑复用	是普通函数，可组合嵌套

📚 推荐阅读

✍️ 结语

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

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