Vue笔记(十五)--自定义引用

作者:BrooklynTree日期:2026/10/26

这一节了解一下Vue3 中的自定义引用,customRef是Vue3提供的一个响应式API,允许你自定义ref的get和set内部逻辑,通过track()收集依赖、trigger()触发更新,从而实现防抖等特殊行为。简单总结如下:

API:
customRef(factory):创建一个自定义的ref,传入一个工厂函数factory
factory 固定参数:track,trigger
track():收集依赖->当数据被模板/计算属性读取时,通知Vue收集当前副作用
trigger():派发更新 ->当数据修改完成后,通知所有收集到的依赖去更新视图
返回值:一个ref对象

场景:
1 防抖,输入框延迟更新,减少频繁请求
2 带本地持久化的ref:读写同时自动存入localStorage
3 读写拦截、数据校验

栗子:

1<template>
2  <div>
3    <input v-model="searchKey" placeholder="输入搜索内容" />
4    <p>实时防抖结果:{{ searchKey }}</p>
5  </div>
6</template>
7
8<script setup>
9import { customRef } from 'vue'
10
11function useDebounceRef(initValue, delay = 500) {
12  let timer = null
13  // customRef 工厂函数,接收 track、trigger
14  return customRef((track, trigger) => {
15    let value = initValue
16    return {
17      get() {
18        track()
19        return value
20      },
21      set(newVal) {
22        clearTimeout(timer)
23        timer = setTimeout(() => {
24          value = newVal
25          trigger()
26        }, delay)
27      }
28    }
29  })
30}
31
32// 使用自定义ref
33const searchKey = useDebounceRef('')
34</script>

Demo02

1<template>
2  <div>
3    <input v-model="username" placeholder="输入用户名" />
4    <p>当前用户名:{{ username }}</p>
5    <button @click="assignIllegal">赋值非法数字</button>
6  </div>
7</template>
8
9<script setup>
10import { customRef } from 'vue'
11
12function useStorageRef(key, defaultValue) {
13  return customRef((track, trigger) => {
14    let value = localStorage.getItem(key) ?? defaultValue
15
16    return {
17      get() {
18        console.log('[读取数据]', value)
19        track() 
20        return value
21      },
22      set(newVal) {
23        console.log('[准备赋值]', newVal)
24        if (typeof newVal !== 'string') {
25          console.warn('赋值失败:数据类型不合法,只允许字符串!')
26          return
27        }
28        value = newVal
29        localStorage.setItem(key, value)
30        trigger()
31        console.log('[赋值成功并持久化]', value)
32      }
33    }
34  })
35}
36
37// 使用自定义引用
38const username = useStorageRef('user_name', '默认用户')
39
40const assignIllegal = () => {
41  username.value = 123456
42}
43</script>
44

原理:

customRef是一个高阶工厂函数,把ref内部的track(收集依赖)、trigger(触发更新)两个核心能力暴露给开发者,让我们手动控制什么时候收集依赖、什么时候派发更新,不再由Vue内部自动处理。

1开始调用 customRef(工厂函数)
2        ↓
3传入全局 track、trigger 给工厂函数
4        ↓
5执行工厂函数 → 得到 {get, set},闭包变量常驻
6        ↓
7返回 ref 实例(标记 __v_isRef = true)
8————————————————————————————————
9【读取 .value】
10        ↓
11执行 get()
12        ↓
13手动 track() → 收集当前effect依赖
14        ↓
15return 数据
16————————————————————————————————
17【修改 .value = newVal】
18        ↓
19执行 set(newVal)
20        ↓
21执行自定义业务逻辑(防抖/校验等等)
22        ↓
23 满足条件手动 trigger()
24        ↓
25取出收集的所有 effect 执行 → 视图更新、watch触发

注意:
1 get里面必须调用track(),否则模板不会收集依赖,视图不更新
2 set修改完数据必须调用trigger(),否则不会通知视图刷新
3 不要在get/set里面写无限循环逻辑


参考文档


《Vue笔记(十五)--自定义引用》 是转载文章,点击查看原文。


相关推荐


【工具】在安卓手机上运行Steam游戏 | DroidDeck
小锋学长生活大爆炸2026/10/18

转载请注明出处:小锋学长生活大爆炸[xfxuezhang.cn] 如果本文帮助到了你,欢迎[点赞、收藏、关注]哦~ 软件介绍 Steam 库里游戏买了一堆,真想玩的时候,要么开电脑串流,要么就算了。最近学长发现了一个开源项目,把这套规矩改了,叫 DroidDeck。它在安卓手机里跑起 Steam 的大屏界面,Windows 游戏本地运算,不走串流那一套,也不用 root。上线三周,GitHub 收了 9.8k 多个 star。 https://github.com/Droid-Dec


Linux --HTTP Cookie 与 Session
0+1112026/10/16

从一个问题开始:B 站是怎么认识我的? 你有没有想过这样一个问题: 我打开 B 站,输入账号密码登录。 然后我刷新页面、点开一个视频、再点开另一个视频…… B 站居然一直知道“我是我”,知道我的昵称、头像、收藏夹。 可是,HTTP 协议是无状态、无连接的。 无状态:每个请求都是独立的,服务器不会记得你上一次请求是谁。 无连接:每次请求响应后,连接就断开了(HTTP/1.1 虽然支持 keep-alive,但本质仍是请求-响应模型)。 那服务器凭什么记住我? 答


Swift Server,又多了一个 Google -- 肘子的 Swift 周报 #156
东坡肘子2026/10/8

Swift Server,又多了一个 Google 上周,Google Cloud 推出了面向服务端的 Swift SDK。它覆盖 Cloud Storage、IAM、Secret Manager、AI 等一百多个 Google Cloud 服务,并提供认证、重试、分页等完整的云端基础能力。Google 对它的定位非常明确:这是为 Server、Container 和 DevOps 准备的 Swift SDK,而不是给 iOS 应用直接访问云服务使用的客户端工具。 与移动端 Firebase S


宝塔面板 + pushplus:系统告警推到微信
爱看日剧的陈大人2026/9/29

宝塔面板 + pushplus:系统告警推到微信 效果:宝塔的面板登录、异常登录、磁盘、证书到期等告警推到微信。 前置条件 一个 pushplus token(官网扫码获取)已安装宝塔面板 配置步骤 打开宝塔 → 面板设置 → 消息推送 / 告警(部分版本在「软件商店」相关插件里)。新增 Webhook 或自定义接口: 请求地址:https://www.pushplus.plus/send请求方式:POSTContent-Type:application/json 若宝


自研 AST 容错初筛工具:横向评测 Django、PyTorch、TensorFlow 三大开源 Python 框架异常收容风险
Liaiyang662026/9/23

声明:本文仅为思想脚手架推演,不具备直接现实落地能力,不可替代硬件安全兜底。如有现实落地需求,请使用者自行综合评估、考量全部安全风险,自行承担全部相关责任。 本文是「空圈容错」系列的代码层落地篇。此前系列文章已将 CMP-D 应用于 BEV 感知、LLM Agent、ROS2 机器人场景,本文则从 Python 源码层面,用 SAST 工具对真实开源项目进行容错缺陷初筛。 摘要:本文介绍一款单文件 AST 表层 SAST 初筛工具【空圈 CMP-D】,不追求漏洞终审,聚焦软件容错、异常收容反模式


Python 开发者也有自己的轻量工作流引擎了:pip install 一行,5 分钟跑通一条审批流
mldong2026/9/15

一、搜"python 工作流引擎",你会先搜到什么 场景很常见:一个 Python 服务(FastAPI / Django / Flask 写的中台、内部系统),产品说要加审批流。请假、报销、采购,单子从申请人出发走到部门领导,复杂一点的要会签、按比例通过、退回发起人改材料、抄送一把手。 你去搜 python workflow,会搜到 Airflow、Prefect、Dagster(数据管道编排),再往外还有 Celery(任务队列)、Temporal(长时任务)、Camunda 的 Pytho


构建无障碍组件之Landmarks Pattern
anOnion2026/9/7

Landmarks Pattern 详解:页面地标区域的无障碍实现 Landmarks(地标)是一组用于标识页面主要区域的 ARIA 角色。本文基于 W3C WAI-ARIA Landmarks Pattern 及 Landmark Regions Practice,详解 8 种地标角色、HTML 原生元素映射与最佳实践。 一、Landmarks 的定义与核心概念 1.1 什么是 Landmarks Landmarks 是 8 个 ARIA 角色的集合,用于标识页面的主要结构区域。每个地标角色让


Python能做嵌入式开发吗?一份写给动手派的生态与硬件全景图
卷无止境2026/8/30

很多人对Python的印象还停留在"跑在电脑或服务器里的脚本语言",写爬虫、搞数据分析、训练模型都行,但嵌入式这种要直接操控芯片、控制引脚电平的活儿,好像轮不到它。这个印象放在十年前基本没错,但放在今天,已经过时了。 答案是能,而且做得相当漂亮。只不过这里有个关键前提,得先搞清楚你说的Python到底是哪一种。嵌入式世界里,Python早就不是单一身份,而是分裂出了几条并行的技术路线,各自服务不同的硬件层级和使用场景。 Python在嵌入式里的三副面孔 先给一张全景图,理清脑子里的概念层级。


Rust where详解:让泛型与Trait约束更加清晰
程序员爱钓鱼2026/8/22

《Rust编程实战》系列第48篇 上一篇文章中,我们学习了Rust泛型Generics,知道可以通过: fn show<T>(value: T) { } 让同一套代码适配不同类型。但泛型本身只表示“类型可以变化”,如果代码需要这个类型具备某种能力,就必须配合Trait Bound。例如: use std::fmt::Display; fn show<T: Display>(value: T) { println!("{}", value); } 这里: T: Display 表示


一行代码没写,我用AI做了一个可以收费产品
大侠Luffy2026/8/9

这是我第一次尝试完全依靠 AI 编程工具,从零到一开发一款产品。整个过程中,我自己一行代码都没有写。 转写模型使用的是 Qwen ASR,GPU 算力来自 Vast.ai。Vast.ai 的消费级 GPU 虽然价格便宜,但想把它做成稳定、可靠的在线服务,并不是一件容易的事。 为了兼顾成本与服务稳定性,我借助 Codex 放弃了官方的 Serverless 方案,从零构建了一套 GPU 实例调度系统。 这个过程中踩了很多坑,但非常值得。如果没有 AI 的帮助,我估计至少需要 3 个月才能把这件事

首页编辑器站点地图

本站内容在 CC BY-SA 4.0 协议下发布

Copyright © 2026 聚合阅读