Vue 3 的 Composition API 与 TypeScript 深度契合,实现“代码即类型”:ref/computed 自动推导、defineProps/defineEmits 泛型校验、Composable 类型穿透、Pinia 与 API 类型联动闭环。

Vue 3 的 Composition API 和 TypeScript 是天然契合的一对,不是“能用”,而是“越用越顺、越写越准”。关键在于它把类型推导从“靠猜+补声明”变成了“代码即类型”的自然过程。
类型推导从 setup 内部自动发生
在 <script setup></script> 中,你声明一个 ref 或 computed,TS 就能立刻识别它的值类型,不需要额外注解(除非需要显式约束)。比如:
-
const count = ref(0)→ 类型是Ref,后续访问count.value就有完整的 number 方法提示; -
const name = ref('')→ 类型是Ref,拼错name.valuIDE 会立刻标红; -
const list = ref→ 显式泛型让数组元素类型清晰,遍历时每个 item 都带([]) User的完整属性提示。
defineProps 和 defineEmits 原生支持泛型校验
组件的输入输出不再靠运行时检查,而是在编写模板和调用时就受控:
-
defineProps()→ 模板里写{{ props.titile }}(少了个 l),TS 编译期报错; -
defineEmits()→ 触发emit('update', 123)(传了 number),TS 直接拦截; - 配合 Volar 插件,父组件传参时也有精准提示和校验,不依赖文档或记忆。
Composable 函数可复用且类型可穿透
自定义 Hook(如 useFetch、useForm)可以做到“一次定义,处处强类型”:
- 函数入参、返回值都用泛型标注,调用时自动推导;
- 例如
useFetch,返回的('/api/user') data类型就是Ref; - 内部逻辑、错误处理、加载状态全部被类型包裹,下游使用无需再做类型断言或
any宽松处理。
Pinia Store 和 API 类型联动形成闭环
全局状态和后端接口不再是类型孤岛:
- Pinia store 的
state和actions参数天然可推导,比如login(payload: { email: string; password: string }); - 搭配
openapi-typescript生成的接口类型,useFetch和userStore.setUser(data)能无缝衔接; - 后端字段增减,前端消费处立刻暴露——不是上线后 500 报错才发现
user.avatar_url改成了user.avatarUrl。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











