trigger 是 Vue3 响应式系统中负责派发更新的核心机制,由 Proxy 的 set 拦截器隐式调用,根据操作类型(SET/ADD/DELETE)触发对应依赖;它与 triggerRef 的区别在于:前者是内部函数作用于 reactive/ref,后者是供开发者手动唤醒 shallowRef 响应的 API。

trigger 函数是 Vue3 响应式系统中负责“派发更新”的核心机制。它不主动监听变化,而是在数据被修改后,自动找出所有依赖该数据的副作用函数(比如 effect、计算属性、组件渲染函数),并依次执行它们,从而驱动视图更新。
trigger 是怎么被调用的?
它由 Proxy 的 set 拦截器隐式触发——当你给响应式对象赋值(如 state.count = 5)、添加属性(obj.newKey = 'val')或删除属性(delete obj.key)时,Vue 内部的 set 处理逻辑会判断操作类型(SET / ADD / DELETE),再调用 trigger 并传入目标对象、操作类型和相关键名。
- 对普通对象,trigger 查找
targetMap.get(target).get(key)对应的依赖集合 - 对数组,除了 key 还会检查
'length'依赖(例如 push 后 length 变了) - 若为新增属性(ADD)且目标是数组,还会触发 length 相关的 effect
trigger 和 triggerRef 有什么区别?
trigger 是底层运行时函数,用户代码中不可直接调用;triggerRef 则是暴露给开发者的 API,专用于 shallowRef 场景。
Vue 3 组合式 API 与 最佳实践,涵盖代码组织、useXxx 模式、组合式函数设计、Store 集成、响应式优化及功能抽取。
- trigger:内部使用,配合 track 完成“收集-触发”闭环,作用于 reactive / ref 创建的深层响应式数据
-
triggerRef:手动唤醒 shallowRef 的响应,因为 shallowRef 只响应
.value = 新对象,不响应.value.xxx = yyy;调用它等于告诉 Vue:“这个 shallowRef 的值虽没换,但内容变了,请更新依赖”
什么时候需要关心 trigger 的行为?
多数时候你不需要碰 trigger,但理解它有助于排查三类典型问题:
立即学习“前端免费学习笔记(深入)”;
- 修改嵌套对象属性后视图没更新 → 可能用了 shallowRef,需搭配 triggerRef
- 动态添加对象新属性(如
obj.foo = 'bar')未触发更新 → reactive 对象支持,但需确保属性在初始化时存在或用nextTick等待依赖收集完成 - 数组 push 后 length 相关逻辑未响应 → trigger 已处理,但若依赖写在 computed 或 effect 中,需确认是否读取了 length 属性
能不能绕过 trigger 自己控制更新?
可以,但不是直接调用 trigger,而是通过更上层的可控方式实现类似效果:
- 用
shallowRef + triggerRef:适合大对象只改内部字段、不想深度响应的场景 - 用
:key="timestamp"强制重渲染组件:适用于整个子树状态失效、需重建的情形 - 用
nextTick+ 数据变更:确保 DOM 更新完成后执行后续逻辑,常用于动画衔接或 DOM 测量

















