You need to enable JavaScript to run this app. Vue Composition API嵌套字段渲染{value:0}而非纯值是预期行为吗
优惠活动
大模型
产品
解决方案
定价
更多

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
  });
}

修改后两种用法都可以正常工作:

  1. 作为对象访问:ctx.counter不需要加.value,模板也能正常渲染
  2. 解构使用:const { counter } = useCounter()得到的依然是Ref,和原有行为一致

补充注意事项

如果你在JS逻辑中直接访问修改上述返回的reactive对象的属性,不需要加.value,比如:

const ctx = useCounter()
// 直接访问即可,不需要ctx.counter.value
console.log(ctx.counter)
ctx.counter = 10

内容的提问来源于stack exchange,提问作者Alex

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.20 00:54:01