核心思路是将防抖逻辑封装进 ref 本身,使 ref.value 赋值天然具备延迟更新能力;通过 customRef 的 get/trigger 控制依赖追踪与更新触发,闭包维护真实值,set 中清除旧定时器并在延迟后更新值并 trigger。

在 Vue 3 中,用 customRef 实现防抖 ref 的核心思路是:把“延迟更新值”这件事封装进 ref 本身,而不是在事件回调或 watch 里反复写 setTimeout。这样,ref.value 的赋值行为天然具备防抖能力,组件内其他逻辑(比如 v-model、计算属性、watch)完全无需感知防抖存在。
基础封装:一个可复用的防抖 ref 工厂函数
创建一个组合式函数(例如 useDebouncedRef),接收初始值和延迟毫秒数:
- 内部维护一个闭包变量存储当前真实值,避免直接操作传入的初始值引用
-
在
get中调用track(),确保模板或计算属性能正确建立依赖 -
在
set中清除旧定时器,设置新定时器;仅在延迟结束后才更新闭包值并调用trigger()
代码示例(TypeScript 支持):
import { customRef } from 'vue'
export function useDebouncedRef<t>(value: T, delay = 300) {
let timeout: NodeJS.Timeout | null = null
return customRef<t>((track, trigger) => ({
get() {
track()
return value
},
set(newValue) {
if (timeout) clearTimeout(timeout)
timeout = setTimeout(() => {
value = newValue
trigger()
}, delay)
}
}))
}</t></t>在组件中直接使用,像普通 ref 一样自然
不需要改写事件绑定方式,v-model 仍可照常使用(Vue 会自动调用 .value 的 get 和 set):
- 模板中:
- 脚本中:
const searchText = useDebouncedRef('', 500) - 后续 watch 或 API 调用时,读取
searchText.value得到的就是防抖后稳定的值
注意几个关键细节
这些点容易出错,但直接影响功能是否可靠:
-
不要在
set里直接返回或提前触发:防抖的本质是“延迟生效”,set方法被调用时只应启动计时器,不能立刻更新value或调用trigger() -
必须清理上一次定时器:否则连续输入会累积多个未执行的
setTimeout,导致最终触发多次或值错乱 -
闭包变量要独立于参数:传入的
value是初始值,真正被读写的是闭包内的变量,否则重置 ref 时可能丢失状态 -
类型泛型
要写全:尤其当初始值是string、number或对象时,确保 TypeScript 能正确推导.value类型
为什么比在 watch 里防抖更干净?
传统方式需要在每个搜索场景里单独写:
- 声明普通 ref
- 用
watch监听它 - 在 watch 回调里手动加
setTimeout+ 清除逻辑 - 再手动触发请求或更新另一个状态
而 customRef 方案让“搜索关键词”这个状态本身就带防抖语义,整个数据流更线性、更内聚,也更容易测试和复用。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










