Composition API 提供了两种在组件中引入响应式状态的方式。因此,你需要在 ref()reactive() 之间决定使用哪一个,或是两者都用。本文将帮助你做出正确的选择,但让我们先快速介绍一下这两种方式。

快速介绍

ref()reactive() 用于跟踪其参数的更改。当使用它们初始化变量时,是向 Vue 提供信息:“嘿,每次这些变量发生更改时,请重新构建或重新运行依赖于它们的所有内容”。

在下面的示例中,单击按钮后 personRefpersonReactive 都会修改 name 属性,随后便会在 UI 上得到响应,但对普通 JS 对象 person 来说就不会。

<template>
  {{ person.name }} <!-- 不会变为 Amy -->
  {{ personRef.name }} <!-- 会变为 Amy -->
  {{ personReactive.name }} <!-- 会变为 Amy -->
  <button @click="changeName('Amy')">Change Name</button>
</template>

<script setup lang="ts">
  import { ref, reactive } from 'vue'

  const person = { name: 'John' }
  const personRef = ref({ name: 'John' })
  const personReactive = reactive({ name: 'John' })

  const changeName = (name: string) => {
    person.name = name
    personRef.value.name = name
    personReactive.name = name
  }
</script>

基本上,它们用于让组件具有响应性(对变化做出反应)。

不同之处

ref()reactive() 主要有三个区别:

  • ref() 函数可以接受原始类型(最常见的是布尔值、字符串和数字)以及对象作为参数,而 reactive() 函数只能接受对象作为参数。
// 无效 const x = reactive(true)
 // 有效 const x = ref(true)

对于对象,这两种语法都是有效的:

// 有效 const x = reactive({ name: 'John'}) 
// 有效 const x = ref({ name: 'John'})
  • ref() 有一个 .value 属性,你必须使用 .value 属性获取内容,但是使用 reactive() 的话可以直接访问:
// 有效 const x = reactive({ name: 'John'}) x.name = 'Amy' // x => { name: 'Ammy' } 
// 有效 const x = ref({ name: 'John'}) x.value.name = 'Amy' // x.value => { name: 'Ammy' }

注意:refs 传递到模板(<template>)时,会被解包,因此你不需要在那里写 .value

  • 使用 ref() 函数可以替换整个对象实例,但是在使用 reactive() 函数时就不行:
// 无效 - x 的更改不会被 Vue 记录 let x = reactive({name: 'John'}) x = reactive({todo: true}) // 有效 const x = ref({name: 'John'}) x.value = {todo: true}

为什么同时存在 ref()reactive()

看起来 reactive() 只是 ref() 的一个限制版本,那么还需要在代码中考虑使用 reactive() 吗?为什么不总是使用 ref()

我深入了解了下 Vue 3 团队为什么要暴露 reactive() 给我们,而不是把它作为内部方法、不提供给 Vue 程序员使用的原因。

最后...发现有一种用例,使用 reactive() 胜过 ref()

改变观点

在此之前,让我们查看 Vue.js 源代码,更好地理解响应式方法之间的关系。

下面是 Vue.js 3 中 ref() 实现的部分代码:

class RefImpl<T> {
	private _value: T
  private _rawValue: T

  public dep?: Dep = undefined
  public readonly __v_isRef = true

  constructor(value: T, public readonly __v_isShallow: boolean) {
    this._rawValue = __v_isShallow ? value : toRaw(value)
    this._value = __v_isShallow ? value : toReactive(value)
  }

  get value() {
    trackRefValue(this)
    return this._value
  }

  set value(newVal) {
    newVal = this.__v_isShallow ? newVal : toRaw(newVal)
    if (hasChanged(newVal, this._rawValue)) {
      this._rawValue = newVal
      this._value = this.__v_isShallow ? newVal : toReactive(newVal)
      triggerRefValue(this, newVal)
    }
  }
}

在第 8 行中,我们每次写 ref(x) 时都会调用一个构造函数。其中发生了一些有趣的事情。

在第 10 行中,调用了 toReactive(x),它只是一个将对象更改为 reactive() 的函数!

结论ref() 在背后就是使用的 reactive(),你可以把 ref() 简单看成:

const myRef = reactive({
  value: "I'm ref!"
})

myRef.value // "I'm ref!"
myRef.value = 'Changed'
myRef.value // "Changed"

什么情况下使用 reactive() 更好?

使用 reactive() 的一个优点是避免样板代码。当使用 refs 时,你可能会因为在代码中到处写 .value 而感到烦恼。但是,如果需要原始值,则无法避免 ref() 的使用……除非将它们放入对象中!

事实证明,在想要将整个状态放入一个变量中时,reactive() 非常方便,就像在选项 API(data())中所做的那样。对比 refreactive() 会跟踪每个属性的变动。

这意味着在 reactive() 中的每个属性都会被视为独立的 ref(), Vue 会据此确定是否需要更新某些依赖于这些属性的内容。

如果想将 ref() 用作状态容器,每当一个属性更新时,使用该状态的任何地方都将被更新。这会触发不必要的重新渲染并减慢应用程序的速度。

以下是使用一个状态变量示例:

const state = reactive({
  person: {name: 'John'},
  isLoading: false,
  updated: true,
  ...
})

结论:你可以将 reactive() 看作未包装的 ref() 容器。如果你想要一个单状态变量,可以在组件内部使用它。

最后的说明

ref()reactive() 在开始时可能看起来非常相似,但它们的目的略有不同。关于这个话题没有好的编程实践,所以一切都取决于你和你的团队如何决定。

在我看来,你应该盲目地选择 ref() 而不是 reactive()。这样代码风格会更加一致,并且你也不需要考虑使用哪一个——编码速度会稍微快一些。使用 .value 访问变量可能会使你感到烦恼,但我认为这可以作为变量是响应性变量的一个标识。使用 reactive() 我们会失去这些信息,必须检查变量定义。

但请记住一个特殊用例,如果你喜欢组件内部状态仅有一个变量,那么 reactive() 就是适合你的正确工具。