Vue 3 组合式 API 结合 TypeScript 可实现强类型逻辑复用:需前置定义泛型与接口、统一错误类型、同步注入 props/emit 类型、封装 MaybeRef 等通用工具类型,并让 Pinia store 状态类型自动推导。

Vue 3 的组合式 API 天然适合逻辑复用,而 TypeScript 能让这些复用逻辑具备完整的类型约束——不是“能跑就行”,而是“类型一错就报”。关键在于把类型定义前置、嵌入到 Composable 函数签名和返回值中,而不是事后补注释或靠猜。
明确 Composable 的输入输出类型
每个自定义 Hook(Composable)都应有清晰的泛型参数和返回接口。比如封装一个通用的数据获取逻辑:
- 用泛型 T 约束响应数据结构,避免返回
any或unknown - 返回对象用 interface 描述字段名、类型及可选性,IDE 能自动提示
data.value?.name - 错误类型统一为
Error | null,不写any,防止后续误判err.message
示例:
interface FetchResultdata: Ref
error: Ref
isLoading: Ref
execute: () => Promise
}
调用时直接传入期望的数据类型:const { data } = useFetch<user>('/api/users')</user>,data.value 就是 User[] | null,无需类型断言。
Biome 是一个基于 Rust 的高性能工具链,适用于 JavaScript、TypeScript、JSX、JSON、CSS 和 GraphQL,它将格式化和 linting 统一到一个工具中。具有 97% 的 Prettier 兼容性以及超过 450 条 lint 规则,Biome 以显著更快的执行速度取代了 ESLint 和 Prettier。
立即学习“前端免费学习笔记(深入)”;
Props 和事件类型同步注入 Composable
当 Composable 需要读取组件 props 或触发 emit 时,不能硬编码类型。正确做法是接收类型参数或从父组件上下文中提取:
- 若 Composable 用于特定组件,可接收
props: UserProps参数,内部直接使用props.id,类型自动推导 - 若需触发事件,把
emit作为函数参数传入,并用Emits类型约束其签名,如(e: 'submit', payload: FormValue) => void - 避免在 Composable 内部写
defineEmits—— 它属于组件层,Composable 只消费
封装通用类型工具提升复用安全度
高频出现的类型模式(如响应式值兼容原始值)应抽成类型工具,避免每个 Composable 重复声明:
-
MaybeRef<t></t>:接受T或Ref<t></t>,适配useCount(num: MaybeRef<number>)</number> -
UnwrapMaybeRef<t></t>:自动解包,让函数内部处理统一为原始类型,不暴露.value细节 - 把这些类型统一放在
src/types/utils.ts,所有 Composable 直接导入使用,改一处全更新
Pinia 状态与 Composable 类型联动
从 store 获取的状态,不要用 store.xxx as string 强转。正确方式:
- 在 store 定义时就用 interface 明确 state 结构,例如
interface AuthState { token: string; user: UserInfo | null } - Composable 中通过
const store = useAuthStore()获取实例,store.user类型自动为UserInfo | null - 若需派生状态,用
computed(() => store.user?.name),返回类型由 TS 自动推导,无需手动标注

















