Vue3 响应式数据最佳实践速查表

背景

ref(),reactive() ???每次记不住该用什么比较合适?

为此整理一个 Vue3 响应式数据最佳实践速查表,涵盖基础值、对象、数组、表单这几类常见场景。


📌 Vue3 响应式数据定义速查表

1. 基础值(string / number / boolean)

👉 推荐用 ref

csharp 复制代码
import { ref } from 'vue'

const count = ref(0)
const title = ref('Hello Vue3')
const isVisible = ref(true)

✅ 场景:计数器、开关、单一状态。


2. 对象(结构化数据)

👉 推荐用 reactive

php 复制代码
import { reactive } from 'vue'

const user = reactive({
  id: 1,
  name: 'Tom',
  age: 20
})

user.name = 'Jerry'   // 直接修改即可

✅ 场景:用户信息、复杂状态对象。

⚠️ 注意:不能整体替换 user = { ... },只能改属性。

👉 如果需要整体替换 → 用 ref({}) 更合适。


3. 数组(列表数据)

👉 推荐用 ref([])

csharp 复制代码
import { ref } from 'vue'

const users = ref<{ id: number; name: string }[]>([])

// 整体替换
users.value = [{ id: 1, name: 'Tom' }]

// 修改内容
users.value.push({ id: 2, name: 'Jerry' })

✅ 场景:表格、分页、查询结果(经常整体替换)。

👉 如果只修改,不会整体替换:

c 复制代码
const tags = reactive<string[]>(['vue', 'react'])
tags.push('angular')

4. 表单数据

👉 推荐用 reactive + toRefs,方便解构使用

php 复制代码
import { reactive, toRefs } from 'vue'

const form = reactive({
  username: '',
  password: '',
  remember: false
})

const { username, password, remember } = toRefs(form)

✅ 场景:登录表单、注册表单、复杂输入表单。

👉 如果表单需要 整体重置,可以这样:

php 复制代码
Object.assign(form, { username: '', password: '', remember: false })

5. DOM 引用

👉 必须用 ref

xml 复制代码
<template>
  <input ref="inputEl" />
</template>

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

const inputEl = ref<HTMLInputElement | null>(null)

onMounted(() => {
  inputEl.value?.focus()
})
</script>

✅ 总结口诀

  • 单值用 ref
  • 对象用 reactive (要整体替换就改成 ref({}))
  • 数组推荐 ref([]) (便于整体替换)
  • 表单用 reactive + toRefs
  • DOM 元素用 ref

相关推荐
feixing_fx5 小时前
第一个 JS 程序:在浏览器控制台和 Node 中分别运行
开发语言·前端·javascript·前端框架·ecmascript
feixing_fx6 小时前
变量与声明:let、const、var 的选择边界
开发语言·前端·javascript·前端框架
JavaGuide8 小时前
Cloudflare 开源的这套神级安全审计 Skill 太好用了!
前端·后端
孟健9 小时前
用 unslop 拯救 AI 生成网页的塑料感,7 分钟重构落地实测
前端·人工智能·ai编程
feixing_fx10 小时前
JavaScript 是什么:从浏览器脚本到通用编程语言
开发语言·前端·javascript·前端框架·ecmascript
丘山望岳10 小时前
【开发工具】 cluade code常用快捷键
前端
小巫编程室10 小时前
我造了一个 Java 能力包:让 AI 直接调用你的业务代码
java·前端·后端
小y的笔记10 小时前
JavaScript URL 状态同步
前端·javascript
十有八七10 小时前
手搓 Agent(五):学会翻书——RAG,先查资料再回答
前端·人工智能·后端
Swot10 小时前
产品 RAG 知识库与 AI 顾问 设计与实现
前端·后端