Vue.js 中 customRef 是实现自定义依赖触发逻辑的唯一标准方案，它通过暴露 track 和 trigger 函数，允许开发者精确控制依赖收集与更新通知的时机，适用于防抖、节流、异步验证、脏检查等场景。
Vue.js 中实现自定义依赖触发逻辑，核心在于绕过默认的响应式行为，接管“什么时候收集依赖”和“什么时候通知更新”的控制权。这主要通过 customRef API 完成，它不封装数据，而是暴露 track 和 trigger 两个函数，让你决定读取时是否记下当前 effect、修改时是否唤醒它。
customRef 是自定义触发逻辑的唯一入口
普通 ref 或 reactive 的 get/set 行为是固定的：读就 track，写就 trigger。而 customRef 把这两个动作拆出来，交由你编程控制：
- get() 中必须显式调用 track()——否则 Vue 不知道谁依赖了这个值，后续改值也不会更新
- set() 中必须显式调用 trigger()——否则即使值变了，依赖它的 computed、watch 或模板也不会重新执行
- 你可以把 track 放在条件判断里（比如只在 loading 为 false 时才收集）、把 trigger 延迟到防抖结束、甚至根据新旧值差异决定是否触发
常见自定义触发场景与写法
不是所有数据都需要“一改就更新”。以下典型需求都依赖手动控制 trigger：
- 防抖更新：输入框频繁修改时，只在停止输入 300ms 后才通知视图，避免中间态反复渲染
- 节流更新：滚动或鼠标移动类高频事件中，限制每秒最多触发一次依赖更新
- 异步验证后更新：比如邮箱字段需调用接口校验格式，仅当校验通过才 trigger，失败则保持原依赖状态
- 脏检查式触发：只在新值真正不同于旧值时才 trigger，避免字符串空格变化等无效更新
关键细节：track 和 trigger 必须成对出现且时机合理
customRef 的工厂函数返回对象，其中 get 和 set 是闭包环境，可共享内部变量（如 timer、prevValue）。但要注意：
立即学习“前端免费学习笔记（深入）”；
- track() 只能在 get 内部调用，且必须在 return 值之前；若漏掉，该 ref 就永远不会被任何 effect 收集
- trigger() 可以延迟调用，但不能在 set 外部（比如异步回调里）直接调用——因为此时 activeEffect 已退出，trigger 会找不到上下文
- 如果 set 中未调用 trigger，哪怕值变了，依赖它的组件也不会重渲染；反之，如果 get 里没调用 track，那这个 ref 根本不会被纳入依赖图谱
不推荐用 markRaw 或 shallowRef 替代 customRef
markRaw 是让对象彻底脱离响应式系统，shallowRef 只代理顶层，都不提供对 track/trigger 的控制。它们适用于“不需要响应性”或“只需浅层响应”的场景，但无法实现“有选择地触发更新”这一目标。真正需要精细调度依赖更新节奏时，customRef 是 Vue 3 提供的唯一标准方案。
