响应式 api 是 vue 3 的底层能力,组合式 api 是其组织方式;前者提供 ref、reactive 等原子响应能力,后者通过 setup 函数整合状态、逻辑与生命周期,二者融合于 中实现可复用、可维护的逻辑封装。

响应式 API 是 Vue 3 的底层能力,组合式 API 是使用这些能力的组织方式——二者不是并列关系,而是“能力”与“用法”的关系。Vue 3 中所有响应式功能(ref、reactive、computed、watch 等)都属于响应式 API;而组合式 API 指的是通过 setup 函数,把响应式状态、逻辑函数、生命周期钩子等按功能聚合成可复用、可维护的代码块。
响应式 API 是组合式 API 的基础支撑
没有响应式 API,组合式 API 就无法运作。Vue 3 的响应式系统基于 Proxy,能自动追踪依赖、触发更新,支持对象增删、数组索引赋值、嵌套结构深层响应等。组合式 API 中所有状态定义都依赖它:
-
ref 包裹基本类型,暴露
.value接口,内部仍由 reactive 代理实现 - reactive 直接返回 Proxy 对象,适用于对象/数组等复杂结构
- computed 和 watch 依赖响应式数据的依赖收集机制,才能精准监听变化
组合式 API 提供了响应式能力的组织范式
响应式 API 只解决“如何让数据变响应式”,而组合式 API 解决“怎么把响应式数据和相关逻辑合理组织起来”。它不强制要求写法,但推荐在 setup 中完成三类集成:
- 声明响应式状态(如
const count = ref(0)) - 定义关联行为(如
const increment = () => count.value++) - 绑定生命周期或副作用(如
onMounted(() => console.log(count.value)))
两者在 <script setup> 中自然融合</script>
使用 <script setup></script> 语法时,响应式 API 的调用与组合式逻辑完全内联,无需手动 return,编译器自动提取暴露给模板:
- 顶层声明的
ref、reactive变量直接可在模板中使用({{ count }}) - 定义的函数(
function reset() { count.value = 0 })自动绑定为事件处理器 - 生命周期钩子(
onMounted、onUnmounted)在 setup 作用域内执行,天然访问所有响应式变量
可拆分、可复用是集成后的核心价值
响应式 API 提供原子能力,组合式 API 把它们打包成逻辑单元。比如一个表单校验逻辑可以封装为:
- 用
ref管理输入值与错误信息 - 用
computed判断是否有效 - 用
watch做实时反馈 - 用
onMounted初始化默认值
这个逻辑块可导出为独立函数,在多个组件中 import 复用,且不污染全局命名空间,也不依赖 this 上下文。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!










