isProxy、isReactive、isReadonly是Vue 3用于类型判断的工具函数:isProxy判断是否为Vue创建的代理(reactive/readonly等),isReactive判断是否为可修改响应式对象(reactive/shallowReactive),isReadonly判断是否为只读代理(readonly/shallowReadonly)。

这三个函数是 Vue 3 响应式系统中用于“识别对象身份”的基础工具,不是用来创建响应式,而是帮你快速判断一个值到底是什么类型。它们不改变数据,只返回 true 或 false,在调试、条件逻辑、封装通用逻辑时特别实用。
isProxy:它是不是 Vue 的代理对象?
只要对象是通过 reactive、readonly、shallowReactive 或 shallowReadonly 创建的,就一定是 Proxy 实例,isProxy 就返回 true。它不管里面有没有嵌套、是不是只读,只看最外层是否被 Vue 代理过。
-
reactive({})→ true -
readonly({})→ true -
ref({})→ false(ref 是个包装对象,内部 value 才可能是 proxy) -
new Proxy({}, {})→ false(不是 Vue 创建的代理,不认)
isReactive:它是不是可修改的响应式对象?
这个函数只对真正由 reactive 或 shallowReactive 创建的对象返回 true。注意一个关键细节:如果 readonly 包裹的是一个 reactive 对象(比如 readonly(reactive({}))),isReactive 依然返回 true——因为它底层确实是个 reactive 代理,只是被套了一层只读壳。
React 与 Next.js 性能优化指南,源自 Vercel 工程团队。适用于编写、审查或重构 React/Next.js 代码时使用。
-
reactive({})→ true -
readonly(reactive({}))→ true -
readonly({})→ false(原始对象没被 reactive 过) -
ref({})→ false(ref 不等于 reactive)
isReadonly:它是不是只读代理?
只要对象是用 readonly 或 shallowReadonly 显式包裹的,无论里面原本是普通对象还是 reactive 对象,isReadonly 都返回 true。它只认“最外层是否加了只读封印”,不关心底层结构。
-
readonly({})→ true -
readonly(reactive({}))→ true -
reactive({})→ false -
shallowReadonly({})→ true
这三者可以组合使用。比如你想确认一个对象既可响应又不可修改,就可以同时检查 isReactive(obj) && isReadonly(obj)。这种判断在封装高阶组件或自定义 Hook 时能避免误操作。

















