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