ReactiveEffect 是 Vue3 响应式系统的核心执行单元,封装副作用函数并支持追踪、调度与停用;其包含 fn、active、deps、options 等字段,run 方法执行函数并触发依赖收集,stop 方法可停用并清理依赖。

ReactiveEffect 是什么
ReactiveEffect 是 Vue3 响应式系统中真正的执行单元,不是用户直接调用的 API,而是 effect() 内部创建的核心对象。它把一个普通函数封装成具备“可被追踪、可被调度、可被停用”能力的副作用实体。
你可以把它理解为 Vue3 里的“响应式任务实例”:每次你在模板里读取 state.count,或在 computed、watch、effect 中访问响应式数据,背后都隐式或显式地生成了一个 ReactiveEffect 实例,并在合适时机运行它。
它的关键结构长什么样
从源码定义看,ReactiveEffect 是一个类,核心字段包括:
-
fn:原始传入的副作用函数,比如
() => console.log(state.name) -
active:布尔值,标识该 effect 当前是否启用(
stop()后设为 false) -
deps:依赖数组,每个元素是一个
Dep(即Set),记录它依赖了哪些响应式属性 -
options:配置项,含
lazy(是否懒执行)、scheduler(自定义调度器)、onStop(停用回调)等
特别注意:deps 不是存数据,而是存“谁依赖了我”——准确说是“这个 effect 依赖了哪些 key”,而每个 key 对应的 Dep 集合里,才真正存着所有监听该 key 的 ReactiveEffect 实例。
run 方法:触发执行与依赖收集的入口
每个 ReactiveEffect 实例都有一个 run() 方法,它是 effect 执行逻辑的统一出口。关键行为有三步:
将 React 应用升级到最新版本,从类组件迁移到 Hooks,并采用并发特性。用于现代化改造 React 代码库、迁移到 React Hooks 或升级到最新
- 若当前 effect 已在执行栈(
effectStack)中,跳过,防止无限递归 - 将自身推入
effectStack,并设为全局活跃 effect(activeEffect = this) - 执行
this.fn();此时内部对响应式对象的任何get操作,都会触发track(),自动把当前activeEffect收集进对应属性的依赖集合
也就是说:run 不仅执行逻辑,还为下一次更新埋好了“监听线索”。这也是为什么 effect 第一次调用就能建立响应关系——执行即收集。
如何停用、清理和复用
ReactiveEffect 提供了明确的生命周期控制能力:
-
stop():设
active = false,并遍历deps,从每个 Dep 中删除自己,彻底断开依赖链 -
resetDep()(内部):清空
deps数组,用于 effect 重新激活或依赖重置场景 - onStop 回调:在 stop 时触发,常用于手动释放资源(如取消定时器、关闭 WebSocket)
这种设计让 effect 可以安全嵌套、按需启停,也为 onInvalidate(watch 中的失效回调)、effectScope 等高级能力提供了底层支撑。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










