isRef() 判断是否为 ref

最后更新:2026-10-22

isRef() 判断是否为 ref

isRef() 判断一个值是否是 ref 对象,常用于工具函数里区分普通值与响应式引用。

分组响应式·工具
类型API
作用域组件内
Vue 版本3.0+
SSR 支持支持

📝 语法

isRef(count)      // true
isRef(0)          // false
isRef(reactive({}))  // false(那是响应式代理)

⚙️ 参数

value任意值

返回值:布尔值

▶ 示例

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

输出:

显示「这是 ref / 这是普通值 / 这是普通值」。

💡 要点

💡 提示 写工具函数时先用 isRef 判断,再决定是否 .value 取值,避免调用方必须统一传 ref。
ℹ️ 说明 reactive 代理不是 ref;嵌套在对象里的 ref 会被自动解包。
更多案例即将上线。

📚 相关教程

❓ 常见问题

Q 什么时候需要它?
A 写可复用工具函数时(参数可能是 ref 也可能是普通值),或调试时确认变量类型。
Q isRef 和 isReactive 有交集吗?
A 没有:ref 包装与 reactive 代理是两套对象,各自判断。
Q 模板里需要判断吗?
A 不需要,模板自动解包 ref,直接当普通值用。
Web-Tutorial.com

Web-Tutorial 技术团队

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

100%

🙏 帮我们做得更好

我们是刚上线的编程教程站,几个人的小团队,精力有限。页面虽经检查,难免还有疏漏——链接失效、排版错乱、内容有误、语言生硬……

如果您发现了,麻烦告诉我们,我们会在收到反馈后第一时间进行修复,再次感谢您的光临 🙏