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<number></number>,后续访问count.value就有完整的 number 方法提示; -
const name = ref('')→ 类型是Ref<string></string>,拼错name.valuIDE 会立刻标红; -
const list = ref<user>([])</user>→ 显式泛型让数组元素类型清晰,遍历时每个 item 都带User的完整属性提示。
defineProps 和 defineEmits 原生支持泛型校验
组件的输入输出不再靠运行时检查,而是在编写模板和调用时就受控:
-
defineProps()→ 模板里写{{ props.titile }}(少了个 l),TS 编译期报错; -
defineEmits()→ 触发emit('update', 123)(传了 number),TS 直接拦截; - 配合 Volar 插件,父组件传参时也有精准提示和校验,不依赖文档或记忆。
Composable 函数可复用且类型可穿透
自定义 Hook(如 useFetch、useForm)可以做到“一次定义,处处强类型”:
立即学习“前端免费学习笔记(深入)”;
- 函数入参、返回值都用泛型标注,调用时自动推导;
- 例如
useFetch<user>('/api/user')</user>,返回的data类型就是Ref<user null></user>; - 内部逻辑、错误处理、加载状态全部被类型包裹,下游使用无需再做类型断言或
any宽松处理。
Pinia Store 和 API 类型联动形成闭环
全局状态和后端接口不再是类型孤岛:
- Pinia store 的
state和actions参数天然可推导,比如login(payload: { email: string; password: string }); - 搭配
openapi-typescript生成的接口类型,useFetch<apiresponse></apiresponse>和userStore.setUser(data)能无缝衔接; - 后端字段增减,前端消费处立刻暴露——不是上线后 500 报错才发现
user.avatar_url改成了user.avatarUrl。


















