watchEffect 是 Vue 3 中自动追踪响应式依赖并立即执行的侦听器,首次运行即触发,变化时自动重跑,无需手动列依赖或配置 immediate;其原理基于 ReactiveEffect 机制,在 getter 中收集依赖、setter 中触发更新,并在组件卸载时自动清理。

watchEffect 是 Vue 3 组合式 API 中一个“写一次、自动盯”的响应式侦听器。它不靠你手动列监听项,而是直接执行一段逻辑,过程中用到哪些响应式数据(比如 ref 或 reactive 的属性),就自动追踪哪些——变化即重跑,首次还立刻执行。省掉写依赖数组、不用配 immediate: true,代码更直白、维护更轻松。
它怎么做到“自动盯”?
背后是 Vue 3 响应式系统的 ReactiveEffect 机制:
- 第一次运行副作用函数时,访问
count.value或user.name等响应式属性,触发 getter,系统悄悄记下“这次用了谁” - 等这些数据后续被修改(触发 setter),Vue 就知道该重跑这个函数了
- 组件卸载时,watchEffect 自动停止,不用手动调用
onUnmounted清理
三种高频实战用法
1. 搜索关键词实时反馈(带防抖)
输入框一变,立刻更新提示文案或发起请求,但要避免连打触发多次请求:
- 在 watchEffect 回调里接收
onInvalidate参数 - 每次新输入时,先清除上一次未完成的定时器或 pending 请求
- 示例中只保留最后一次输入 300ms 后的请求,干净利落
2. DOM 更新后读取内容(如获取渲染后的尺寸)
需要确保拿到的是更新完毕的真实 DOM:
- 默认
flush: 'post'(可省略),函数在 DOM 更新后执行 - 搭配
ref绑定元素,el?.offsetHeight就能拿到准确值 - 若需在更新前操作(比如提前移除 class),改用
flush: 'pre'
3. 手动控制监听生命周期
不是所有监听都要活到组件销毁:
- watchEffect 返回一个停止函数,比如
const stop = watchEffect(...) - 点击按钮、关闭弹窗、切换 Tab 时调用
stop(),立刻切断追踪 - 适合临时性交互逻辑,避免无效计算和内存残留
和 watch 到底怎么选?
看需求重心:
- 想“只要数据变,我就干活”,且逻辑只依赖当前值 → 选 watchEffect(简洁、少出错)
- 需要对比新旧值(比如只在从空变非空时发请求)、或监听深层嵌套对象的任意改动 → 选 watch(更精细、更可控)
- 只是把响应式数据加工成另一个响应式值 → 优先用 computed(缓存、声明式)
不复杂但容易忽略:watchEffect 不提供 oldValue / newValue,也不支持 deep 配置——它专注“响应即执行”,而不是“分析怎么变”。用对地方,代码会清爽一大截。










