You need to enable JavaScript to run this app. Vue3中未用ref声明的普通变量为何会在模板中同步更新?
优惠活动
大模型
产品
解决方案
定价
更多

Vue3中未用ref声明的普通变量为何会在模板中同步更新?

问题描述

在使用Vue 3组合式API过程中,用户的原有认知与测试结果出现偏差:

  • 按照规则理解:只有通过ref包裹定义的变量才具备响应性,普通变量不具备响应性,修改普通变量不会触发模板内容更新。
  • 实际测试中:普通定义的计数器和ref定义的计数器一样,在点击按钮后完成了自增渲染。

测试用代码如下:

<script src="https://unpkg.com/vue@next"></script>
<div id="app">
  <my-component></my-component>
</div>
<script>
  const app = Vue.createApp({});
  app.component("my-component", {
    template: `
      <div>
        <ul>
          <li>普通定义的计数器:{{ countNotReactive }}</li>
          <li>ref定义的计数器:{{ countReactive }}</li>
        </ul>
        <button @click="inc">+1</button>
      </div>
    `,
    setup() {
      const countNotReactive = 1;
      const countReactive = Vue.ref(1);

      return {
        countNotReactive,
        countReactive
      };
    },
    methods: {
      inc() {
        this.countNotReactive++;
        this.countReactive++;
      }
    }
  });
  app.mount("#app");
</script>

实际渲染效果:

<!-- 初始渲染 -->
<div>
  <ul>
    <li>普通定义的计数器:1</li>
    <li>ref定义的计数器:1</li>
  </ul>
  <button>+1</button>
</div>

<!-- 点击按钮1次后 -->
<div>
  <ul>
    <li>普通定义的计数器:2</li>
    <li>ref定义的计数器:2</li>
  </ul>
  <button>+1</button>
</div>

用户核心疑问:

  1. 为什么普通变量的更新效果和“普通变量不具备响应性”的规则预期不符?
  2. ref的实际作用是什么,如何直观体现ref变量与普通变量的核心差异?

原因解析

出现认知偏差的核心,是混淆了「组件代理对象的赋值触发的强制重渲染」和「变量本身的响应式追踪能力」两个概念:

  • 所有setup()返回的属性,无论是不是用ref/reactive包裹,都会被Vue挂载到组件的渲染上下文代理上,也就是this能访问、模板能直接读取这些属性的值。
  • 这个渲染上下文代理本身是响应式对象,只要你通过this给代理上已存在的key赋值,就会主动把组件的更新任务加入渲染队列。原案例里的普通计数器更新,本质上是在this上做了一次赋值,触发了重渲染,并不是普通变量自己具备了响应性。
  • 重渲染触发后,模板会重新读取this上的属性值,这时读到了刚才被赋值的普通计数器的新值,就形成了“普通变量也能响应更新”的错觉。
  • 换句话说,原案例里普通计数器的更新是“搭便车”实现的:如果没有ref变量自增触发的响应式更新,就算单独执行this.countNotReactive++,更新也是来自代理对象的赋值逻辑,和普通变量本身的响应能力没有关系。

直观体现ref与普通变量差异的示例

只要把变量的修改逻辑从methods移到setup作用域内,直接通过闭包操作变量本身,不经过this代理,两者的差异会立刻显现:

<script src="https://unpkg.com/vue@next"></script>
<div id="app">
  <my-component></my-component>
</div>
<script>
  const app = Vue.createApp({});
  app.component("my-component", {
    template: `
      <div>
        <ul>
          <li>普通定义的计数器:{{ countNotReactive }}</li>
          <li>ref定义的计数器:{{ countReactive }}</li>
        </ul>
        <button @click="inc">+1</button>
      </div>
    `,
    setup() {
      const countNotReactive = 1;
      const countReactive = Vue.ref(1);

      function inc() {
        countNotReactive++; // 直接修改setup作用域内的普通变量
        countReactive.value++; // 直接修改ref包裹的变量
        console.log("普通变量的最新值:", countNotReactive); // 控制台可确认变量确实被修改
      }

      return {
        countNotReactive,
        countReactive,
        inc
      };
    }
  });
  app.mount("#app");
</script>

改造后的实际效果:

  • 点击按钮后,控制台能打印出普通变量的最新值,证明变量本身的修改是生效的
  • 模板里的普通计数器始终停留在初始值1,只有ref定义的计数器会随点击从1开始累加

两者的本质差异:

  • 普通变量的修改过程没有被响应式系统追踪,修改完成后不会主动触发任何组件重渲染逻辑
  • ref包裹的变量的修改会被响应式系统捕获,自动触发组件重新渲染、更新模板内容

补充说明:如果在改造后的示例里单独加一个只执行this.countNotReactive++的按钮,会发现普通计数器也能更新——这就是之前提到的this代理的赋值触发重渲染的特性,和普通变量本身的响应性无关。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.17 07:15:08