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,直接当普通值用。