优先用 reactive 管理结构明确的复杂类型对象或数组(如表单、列表),用 ref 处理单个值、原始类型或独立状态(如加载态、计数器);二者常混合使用,配合 toRefs 避免解构失活。

reactive 用于创建响应式对象,内部基于 Proxy,只支持对象、数组、Map、Set 等复杂类型;ref 用于包装任意类型(包括原始值),通过 .value 访问和修改,模板中自动解包无需写 .value。
什么时候用 reactive?
适合定义结构明确、嵌套较深的对象或数组,比如表单数据、列表状态、配置项等。它让整个对象变成响应式,语法简洁,嵌套属性天然响应。
- 声明时必须是对象或数组,不能是字符串、数字、布尔值等原始类型
- 解构后会丢失响应性(需配合
toRefs使用) - 不推荐在模板中频繁访问深层嵌套属性(如
user.profile.address.city),可能影响可读性和调试
什么时候用 ref?
适合处理单个值、函数返回值、异步获取的数据、或者需要在组合式 API 中保持响应性的原始类型变量。
一个基于官方 Mailtrap Node.js SDK 构建的 ASE 技能,用于发送事务邮件并与 Mailtrap 沙盒或生产流程协作。它非常适合需要 API 驱动邮件投递、测试邮箱验证和结构化消息自动化的代理工作流。
- 可包装任何类型:字符串、数字、布尔、null、甚至 Promise 或组件实例
- 在 setup 中必须通过
.value修改,但在模板中直接写count即可(Vue 自动解包) - 与
v-model配合更自然,也更适合做响应式参数传递(如自定义 Hook 的输入)
常见混合使用场景
实际开发中两者常搭配使用:用 reactive 管理主体数据结构,用 ref 控制开关、计数器、加载状态等独立信号量。
- 例如:
const form = reactive({ name: '', email: '' })+const loading = ref(false) - 需要把 reactive 对象的某些属性单独暴露给模板或子组件时,用
toRefs(form)转成一连串 ref,避免解构失活 - 在 TypeScript 中,ref 的类型推导更稳定,尤其对联合类型或泛型函数返回值
性能与可维护性小提醒
不要为了“统一”强行只用某一种。ref 更灵活但略显啰嗦;reactive 更直观但有类型和解构限制。选型依据应是语义清晰、不易出错、便于协作理解。
- 简单状态(开关、计数、ID)→ 优先 ref
- 业务实体(用户、订单、配置)→ 优先 reactive
- 不确定时,先用 ref,后期重构为 reactive 更安全(反之则可能引发响应性丢失)
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










