isRef 和 isReactive 是 Vue 3 中用于类型守卫的响应式检测工具：isRef 判断是否为 ref 对象并支持 .value 安全访问，isReactive 判断是否为 reactive 创建的代理对象以避免深层污染，二者均提供 TypeScript 类型缩小能力。
isRef 和 isReactive 是 Vue 3 响应式系统中两个轻量但关键的类型检测工具，不改变数据，只回答“它是不是 ref？”或“它是不是 reactive 创建的响应式对象？”。它们最实用的地方不只是做判断，而是在 TypeScript 环境下配合类型守卫（type guard），让后续代码获得更精确的类型推导，避免 .value 访问错误或类型断言。
isRef：精准识别 ref 对象，避免误解包
isRef(value) 返回 boolean，用于检测一个值是否由 ref()、shallowRef() 或 customRef() 创建。它内部检查对象是否具有 __v_isRef: true 标识（RefImpl 实例的固定标记）。
常见误用场景：把普通对象或 reactive 对象当成 ref 解构后直接读 .value，会报错或返回 undefined。用 isRef 可提前拦截：
- 接收泛型参数的组合函数中，统一处理 ref / 非 ref 输入：function useCount(source: number | Ref
) { if (isRef(source)) { return source.value; } else { return source; } } - 在 props 解构或解构响应式对象时保护类型：const { data } = defineProps(); if (isRef(data)) { console.log(data.value); // TS 知道 data 是 Ref
，.value 安全 } - 模板中自动解包仅适用于顶层 ref；若从 computed 或函数返回 ref，需手动判断是否要取 .value —— isRef 就是这个判断依据。
isReactive：区分 reactive 与普通对象，防止深层污染
isReactive(value) 检测该值是否为 reactive()、shallowReactive() 或 readonly()（非只读 proxy）创建的响应式代理对象。它通过检查对象是否为 Proxy 实例 + 内部标识（如 __v_raw）来判定。
立即学习“前端免费学习笔记（深入）”；
从零开始编排 SpringBoot+Vue 全栈项目工作流，适用于新建全栈项目或完整脚手架请求，触发后依次调用 product‑spec‑builder（需求调研）等模块。
典型实战需求：
- 深克隆前跳过响应式对象：避免对 Proxy 递归遍历导致死循环或报错。function deepClone(obj) { if (isReactive(obj)) return toRaw(obj); // 先转原始对象再克隆 ... }
- 状态合并逻辑中差异化处理：if (isReactive(target)) { Object.assign(target, source); } else { throw new Error('target must be reactive'); }
- 调试时快速确认响应式层级：比如在 watch 回调里打印 isReactive(val)，能立刻知道传入的是 reactive 对象还是普通对象字面量，辅助定位响应失效原因。
类型守卫：让 TypeScript “看懂”你的判断
isRef 和 isReactive 都是标准的 TypeScript 类型守卫函数（返回 value is Ref
例如：
- function processInput(input: Ref
| string) { if (isRef(input)) { input.value.length; // ✅ TS 知道 input 是 Ref ，.value 存在 } else { input.length; // ✅ TS 知道 input 是 string } - 没有 isRef 时，你可能得写 (input as Ref
).value —— 强制断言不安全，且无法静态校验；加上 isRef 后，既安全又可推导，还能被 IDE 自动补全支持。
搭配 unref：简化“可能是 ref，也可能不是”的通用访问
isRef 常和 unref 一起用：先 isRef 判断，再决定是否 unref。但更简洁的做法是直接 unref —— 它内部已做了 isRef 检查：unref(x) 等价于 isRef(x) ? x.value : x。
所以日常开发中：
- 纯逻辑判断 → 用 isRef / isReactive（尤其需要分支不同行为时）
- 统一取值 → 直接 unref（比如 setup 中接收 prop、computed 或 provide 的值）
- 需要类型精度 + 运行时分支 → 二者结合，发挥类型守卫优势
