选 ref 还是 reactive 取决于数据类型和使用方式:基本类型必须用 ref;对象/数组优先 reactive;需整体替换时 ref 更安全;解构传递时 reactive 需 toRefs,ref 更统一。

选 reactive 还是 ref,关键看数据类型和使用方式是否匹配——不是凭感觉,而是按规则来。
看数据类型:基本类型只能用 ref
JavaScript 的 number、string、boolean、null、undefined 无法被 Proxy 直接代理,所以 reactive 对它们无效,传入会报错或静默失效:
-
reactive(42)→ 报错:Cannot create reactive object from primitive value -
reactive('hello')→ 同样不工作 - 而
ref(42)、ref('loading...')、ref(true)全都合法且响应式
只要变量代表一个“单一值”,比如页码、开关状态、错误提示文本,就该用 ref。
看结构稳定性:对象/数组优先 reactive
当数据是结构明确、属性稳定的对象或数组时,reactive 更直观、更少干扰:
-
const form = reactive({ username: '', password: '' })→ 可直接写form.username = 'admin' -
const list = reactive([{ id: 1, name: 'A' }])→ 可直接list.push(...)或list[0].name = 'B' - 不需要
.value,模板里也直接写{{ form.username }}
如果对象嵌套深、字段多、更新频繁,reactive 的深层响应式默认开启,省去手动处理子属性的麻烦。
使用 assistant-ui 构建具有可重用线程、运行时、消息组件和模型/提供者适配器的生产级 React 聊天界面。
看是否需要整体替换:ref 支持安全赋值
有时逻辑需要把整个数据替换成新对象,比如接口返回新用户信息、分页切换时重置列表:
-
user.value = response.data→ref安全,响应性保留 -
user = response.data→reactive下这行代码会让user变成普通对象,响应性丢失 - 若坚持用
reactive,必须用Object.assign(user, response.data)或逐个赋值,不够干净
需要“可替换”的场景(如缓存刷新、表单重置、动态配置加载),ref 更灵活。
看组合式 API 中的解构与传递
在 setup 或 script setup 中,常要把响应式数据解构后传给函数或子组件:
-
reactive解构后(如const { count } = state)会丢失响应性,必须配合toRefs(state) -
ref解构后(如const { count } = refs)仍是 ref,但需统一用count.value访问,略显啰嗦 - 若多个 ref 需一起暴露,用
ref更统一;若是一组强关联属性,用reactive+toRefs更清晰
没有绝对优劣,但 reactive 更适合“一组相关状态”,ref 更适合“独立原子状态”。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!









