unref 和 isRef 是 Vue 工具函数中处理“可能为 ref 或普通值”输入的关键辅助函数：unref 安全解包 ref 取值，isRef 精准识别 ref 类型，二者配合实现健壮通用的响应式逻辑。
在 Vue 工具函数开发中，unref 和 isRef 是两个轻量但关键的响应式辅助函数，它们帮你安全地处理“可能是 ref、也可能是普通值”的输入，避免手动判断类型或重复调用 .value，让工具逻辑更健壮、更通用。
为什么工具函数常需 unref 与 isRef？
Vue 组合式 API 中，用户传入的参数可能是响应式 ref（如 ref(1)），也可能是原始值（如 1 或 "hello"）。尤其在封装可复用的工具函数（比如防抖、格式化、计算属性生成器）时，你无法预设调用方一定用 ref 包裹数据。若直接访问 .value，对非 ref 值会报错；若完全不处理 ref，又无法响应式更新。这时 isRef 判断类型 + unref 安全解包，就成了标准解法。
unref：统一取值，一步到位
unref 的行为很简单：如果是 ref，返回其 .value；否则原样返回。它不改变原始值，也不创建新 ref，纯属“安全读取”。
- 适用于所有需要“先取值再操作”的场景，比如数值计算、字符串拼接、对象属性访问
- 比手写
val?.value ?? val更简洁，且支持嵌套 ref（如ref(ref(42))） - 在工具函数内部应优先使用
unref处理入参，而非假设它是 ref 或原始值
isRef：精准识别，按需分支
isRef 返回布尔值，只判断是否为 Vue 创建的 ref 对象（含 shallowRef、customRef 等），不关心内容是否响应式。它适合需要“区别对待”的逻辑分支。
立即学习“前端免费学习笔记（深入）”；
- 当你要对 ref 做监听（
watch）、解构（toRefs）或透传给其他组合式函数时，先用isRef确认再操作 - 配合
unref可实现更精细控制，例如：仅对 ref 做响应式 watch，对原始值做一次性计算 - 注意：
isRef(reactive({}))返回false，isRef(ref(reactive({})))才是true
实战示例：一个通用的「带默认值的响应式 getter」
假设你写一个工具函数 useDefault，接收一个可能为 ref 的值和一个默认值，返回一个响应式代理——当原值未定义时自动 fallback：
import { ref, computed, isRef, unref } from 'vue'
function useDefault(source, defaultValue) {
// 判断 source 是否为 ref，决定如何构建响应式逻辑
if (isRef(source)) {
return computed(() => unref(source) ?? unref(defaultValue))
} else {
// source 是普通值，直接用 computed 包一层，但 defaultValue 仍需 unref（它也可能为 ref）
return computed(() => source ?? unref(defaultValue))
}
}
这个函数能同时接受 useDefault(count, 0)、useDefault(ref(count), ref(0))、useDefault(countRef, 0) 等多种组合，无需调用方额外适配。
不复杂但容易忽略：真正让工具函数具备“框架级兼容性”的，往往就是这些细小却严谨的类型桥接逻辑。
