unref 用于安全读取 ref 的 .value 或原样返回普通值，避免类型错误；适用于自定义 Hook、props 处理等场景，仅解一层 ref，不递归，需深度解包时配合 toValue。
unref 的作用很直接：传一个值进去，如果是 ref，就取它的 .value；如果不是，就原样返回。它不改数据、不创建新对象，只做“安全读值”这件事，让 ref 和普通值在函数里能被一视同仁地处理。
什么时候必须用 unref？
当你写的函数可能被传入 ref，也可能被传入普通值时——比如自定义 Hook、校验工具、防抖逻辑、或者接收 props 的组合式函数。如果硬写 .value，遇到普通值会报错；如果完全不处理 ref，又拿不到响应式更新后的最新值。
- props 中某个字段可能是
ref(string)，也可能是字符串字面量 - 用户调用你的工具函数时，想传
ref(5)保持联动，也想传10快速调试 - computed 返回值可能是 ref，也可能是普通计算结果（尤其搭配泛型时）
怎么用？两行代码就搞定
从 vue 导入后直接调用，不需要额外判断：
import { ref, unref } from 'vue'
<p>const countRef = ref(100)
const countPlain = 200</p><p>console.log(unref(countRef)) // 100
console.log(unref(countPlain)) // 200
它内部等价于：isRef(val) ? val.value : val，但你不用自己写这个判断。
常见误区提醒
unref 只解一层 ref，且只对 ref 类型生效：
- 对
reactive({ x: 1 })整体调用unref，返回的是 Proxy 对象，不会解包 - 对
shallowRef、computed这类 ref 变体同样适用 - 如果值是嵌套 ref（比如
ref(ref(42))），unref 不会递归解，只取外层 .value - 需要深度解包或支持函数执行？考虑 Vue 3.3+ 的
toValue
配合 isRef 做更精细控制
unref 是“自动取值”，isRef 是“先问再定”。当你要分支处理（比如只对 ref 做副作用，普通值跳过），就该用 isRef：
import { isRef } from 'vue'
<p>function handleInput(value) {
if (isRef(value)) {
console.log('这是 ref，可以监听变化')
watch(value, () => { /<em> ... </em>/ })
} else {
console.log('这是普通值，直接用')
}
}
两者不是替代关系，而是协作关系：unref 简化取值，isRef 支持逻辑分叉。
