unref() 取出 ref 的值

最后更新：2026-10-22

unref() 是 isRef(v) ? v.value : v 的简写：ref 取出内部值，普通值原样返回。

📝 语法

unref(count)   // 等价 count.value
unref(42)      // 42

ref	ref 或任意普通值

返回值：ref 的内部值，或原值

修改下面的代码，在预览区实时查看效果：

输出：

显示「当前计数：17」。

💡 提示 需要动态值的场合（拼接、比较、传给非 Vue 库）用它取值最省心。

⚠️ 注意 unref(ref(0)) 返回 0——别用真假判断它是否“有值”，类型判断请用 isRef。

更多案例即将上线。

Q 和直接写 .value 有什么区别？

A unref 对普通值安全（不报错），.value 用在普通值上是 undefined。

Q 模板里还需要它吗？

A 不需要，模板自动解包；它在 JS 逻辑里用。

Q 和 toValue 的区别？

A toValue 还能处理 getter 函数（3.3+），unref 只认 ref。

Web-Tutorial 技术团队

由多位开发者共同维护的编程教程平台。每篇教程由对应领域的开发者编写和审核，确保内容准确可靠。如发现任何问题，欢迎向我们反馈。