TypeScript 中泛型不作用于 fetch() 本身,而是用于响应解析(如 response.json<T>())、泛型响应接口(如 ApiResponse<T>)及封装函数(如 fetchData<T>()),实现请求输入、传输、输出全程类型安全。

Fetch 本身不带泛型,TypeScript 中的泛型不是加在 fetch() 上,而是加在你对响应数据的解析和封装逻辑里——核心是“告诉编译器你期待什么结构的数据”,并在关键节点显式标注类型参数。
定义泛型响应接口(如 ApiResponse)
统一后端返回格式,让所有请求共享同一套类型契约。常见结构包含状态码、消息、实际数据体:
- 用
interface声明泛型响应体,T代表业务数据类型 - 支持可选字段(如
message?: string)、空值容错(如data: T | null) - 示例:
interface ApiResponse<T> {
code: number;
message: string;
data: T | null;
}
在 .json() 解析时使用泛型调用
response.json() 默认返回 any,必须通过泛型语法明确告知 TypeScript “我要解析成什么”:
- 推荐写法:
await response.json<User>()—— 类型安全,编译器会校验调用处是否传入合法类型 - 避免仅用类型断言:
response.json() as User,它绕过部分检查,容易掩盖结构不一致问题 - 注意:泛型只约束解析结果的使用方式,不校验真实响应内容;接口定义必须与后端实际返回严格一致
封装泛型请求函数
把重复逻辑抽出来,让每个请求调用都自动获得类型推导:
立即学习“Java免费学习笔记(深入)”;
- 函数签名声明
<T>,返回Promise<ApiResponse<T>>或直接Promise<T> - 内部做错误判断(
!response.ok),再调用response.json<T>() - 调用时传入具体类型:
fetchData<Product>('/api/products/1'),IDE 能立刻提示Product的字段
配合请求参数做泛型约束(进阶)
不只是响应,请求体、路径参数、查询参数也可以类型化:
- 为 POST 请求定义
type CreateUserReq = { name: string; email: string } - 封装函数时用双重泛型:
async function post<Req, Res>(url: string, body: Req): Promise<Res> - 调用:
post<CreateUserReq, User>('/api/users', { name: 'Alice', email: 'a@b.com' }) - 这样整个请求链路(输入 → 发送 → 响应)都在类型系统覆盖下


















