TypeScript 泛型:2025 年终极指南

原文链接 TypeScript Generics: The Ultimate Guide, 2025 - 作者 Andre K.

大家好!

本文,我们将探讨 TypeScript 中的泛型,它们是什么?并且怎么去使用它们?

TypeScript 中的泛型是一个功能强大的工具,便于编写可复用性和类型安全的代码。不管你是新手还是老手开发者,掌握泛型将会提升你的 TypeScript 技能。

在这个完整的指南中,我们将学到:

  • 什么是泛型,并且为什么要掌握
  • 在函数,接口和类中,如何使用泛型
  • 真实案例中的最佳实践
  • 高级模式(条件类型,映射类型等)

最后,我们将在 TypeScript 中很自信地使用泛型。下面开始进入主题👇

1. TypeScript 中的泛型是什么?

泛型允许我们在不牺牲类型安全的前提下编写弹性和可复用的组件。当处理不同的数据类型时,泛型允许我们保留类型,而不是使用 any。

用什么使用泛型?

  1. 避免代码重复 - 编写一个函数来涵盖不同类型
  2. 更好的类型引用 - 自动补全和错误提示
  3. 比 any 更安全 - 严格的类型维护,而没有运行时错误

基本的泛型案例👇

typescript 复制代码
function identity<T>(arg: T): T {
  return arg;
}

// 使用
const output = identity("Hello Generics from ITsoftMake.COM"); // 类型:字符串
const numOutput = identity(42); // 类型:数字

在这里,<T> 是一个类型变量,来捕获输入的类型。

2. 在函数中使用泛型

泛型函数👇

typescript 复制代码
function logAndReturn<T>(value: T): T {
  console.log(value);
  return value;
}

const result = logAndReturn(23); // 打印出: 23

多个类型参数👇

typescript 复制代码
function merge<T, U>(obj1: T, obj2: U): T & U {
  return { ...obj1, ...obj2 };
}

const merged = merge({ name: "Andre" }, { age: 30 }); // { name: "Andre", age: 30 }

3. 在接口和类中使用泛型

泛型接口👇

typescript 复制代码
interface ApiResponse<T> {
  data: T;
  status: number;
}

const userResponse: ApiResponse<{ name: string }> = {
  data: { name: "Ritesh" },
  status: 200,
}

泛型类👇

typescript 复制代码
class DataStorage<T> {
  private data: T[] = [];
  
  addItem(item: T) {
    this.data.push(item);
  }
  
  getItems(): T[] {
    return this.data;
  }
}

const stringStorage = new DataStorage<string>();
stringStorage.addItem("TypeScript Generics - Hi from ITsoftMake.COM");

4. 高级泛型模式

默认泛型类型👇

typescript 复制代码
function fetchData<T = string>(url: string): Promise<T> {
  return fetch(url).then(res => res.json());
}

通过继承 extends 进行约束👇

typescript 复制代码
interface HasId {
  id: number;
}

function getById<T extends HasId>(items: T[], id: number): T | undefined {
  return items.find(item => item.id === id);
}

条件型类型👇

typescript 复制代码
type CheckNumber<T> = T extends number ? "Yes" : "No";
type A = CheckNumber<42>; // "Yes"
type B = CheckNumber<"TS">; // "No"

5. 真实使用案例

API 包装(通过类型安全进行获取)👇

typescript 复制代码
async function fetchUser<T>(userId: string): Promise<T> {
  const response await fetch(`/api/users/${userId}`);
  return response.json();
}

const user = await fetchUser<{ name: string }>("123");

实用函数(比如:map,filter 等)👇

typescript 复制代码
function mapArray<T, U>(arr: T:[], mapper: (item: T => U)): U[] {
  return arr.map(mapper);
}

const numbers = [1, 2, 3];
const doubled = mapArray(numbers, x => x * 2); // [2, 4, 6];

6. 常见错误和最佳实践

是否推荐 理由
NO 过度使用 any 而不是泛型 -> 会丢失类型安全
YES 当需要时使用约束(extends) -> 确保正确的类型
NO 过度嵌套泛型 -> 晦涩难懂
YES 保持简单的泛型并配备相应的文档 -> 这很棒

总结

泛型让 TypeScript 容易扩展和可维护。有效地使用它们,我们可以通过下面来实现👇

  • 编写可复用的函数和类
  • 提高类型安全 而不是用 any
  • 优雅处理复杂数据结构

接下来: 尝试在我们的项目中使用泛型吧!

更多的内容官方 TypeScript 泛型文档

相关推荐
kyriewen20 小时前
编辑弹窗点了取消,列表里的数据怎么还是变了?
前端·javascript·人工智能
Karl_fang20 小时前
🥳 再也不用拿起手机抄验证码!我做了一个 Android → Mac 的「验证码接力」工具
前端·macos·ai编程
谭光志21 小时前
如何让 AI 高效工作
前端·后端·ai编程
code2cat1 天前
【随笔】MCP长任务:查询已经返回,为什么任务还没有完成
javascript·人工智能·后端·mcp
FRing031 天前
vue2干货总结11(短信验证、登录功能、统一处理错误(响应拦截器)、将token信息存入vuex、vuex持久化处理)
开发语言·前端·javascript·vue.js·vue2
泯泷1 天前
改一个字,整段都红了?——中文内容差异对比的算法与协议设计
前端·javascript·typescript
再吃一根胡萝卜1 天前
DSH plugin 开发示例:五种插件形态完整代码整理
前端
afumu1 天前
免费 API 满地都是,为什么还有人做「让网页 AI 干活」这种东西
javascript·chrome·浏览器
Yk酱228401 天前
A2UI随笔-demo-01
前端
云起SAAS1 天前
本地生活同城多商户商城系统源码源码 合伙人分红加区域代理加排队返现
前端·javascript·后端