Vue Composition API嵌套字段渲染{value:0}而非纯值是预期行为吗
问题结论
这是完全符合预期的行为,核心原因和toRefs的特性、Vue模板的Ref解包规则有关。
原因说明
toRefs的作用是将reactive对象的每一个顶层属性都转换为独立的Ref对象,你在返回值中展开toRefs(ctx)后,返回的普通对象里的counter等属性本身就是Ref实例,在JS代码中访问必须加.value才能拿到原始值。- Vue模板只会自动解包顶层的Ref变量,你把多个Ref放在一个普通对象
ctx里返回给模板时,ctx.counter属于嵌套在普通对象里的Ref,模板不会自动解包,因此会直接输出Ref对象的结构,也就是你看到的{ "value": 2 }。而单独解构出来的counter是顶层Ref,模板会自动解包,所以能正常输出数值。
兼容两种用法的解决方案
如果你想要组合式函数同时支持「解构使用」和「直接作为对象访问属性(不用加.value)」,可以将返回值整体包裹为reactive对象:
const useCounter = () => { const ctx = reactive({ counter: 2, // ... }); const fn = () => { console.log('Called', ctx.counter); } setInterval(() => ctx.counter += 1, 1000); // 这里把toRefs的结果和方法合并后转成reactive return reactive({ ...toRefs(ctx), fn }); }
修改后两种用法都可以正常工作:
- 作为对象访问:
ctx.counter不需要加.value,模板也能正常渲染 - 解构使用:
const { counter } = useCounter()得到的依然是Ref,和原有行为一致
补充注意事项
如果你在JS逻辑中直接访问修改上述返回的reactive对象的属性,不需要加.value,比如:
const ctx = useCounter() // 直接访问即可,不需要ctx.counter.value console.log(ctx.counter) ctx.counter = 10
内容的提问来源于stack exchange,提问作者Alex
相关产品推荐
相关产品推荐

