以下是 TypeScript 中 Adapter 模式的快速入门指南（以 HTTP 请求库为例）：

1. Adapter 是什么？

Adapter（适配器）是一种设计模式，用于连接两个不兼容的接口。在 TS 中常用于：

• 封装第三方库（如 Axios → 统一 HTTP 请求接口）
• 转换数据格式（如 API 响应 → 前端模型）
• 统一不同类的行为

2. 快速实现示例：HTTP 请求适配器

假设需要统一封装 Axios：

步骤 1：安装依赖

npm install axios

步骤 2：定义适配器接口

// HttpAdapter.ts
export interface HttpAdapter {
  get<T>(url: string): Promise<T>;
  post<T>(url: string, data: any): Promise<T>;
}

步骤 3：实现 Axios 适配器

import axios, { AxiosResponse } from "axios";
import { HttpAdapter } from "./HttpAdapter";

export class AxiosAdapter implements HttpAdapter {
  async get<T>(url: string): Promise<T> {
    const response: AxiosResponse<T> = await axios.get(url);
    return response.data;
  }

  async post<T>(url: string, data: any): Promise<T> {
    const response: AxiosResponse<T> = await axios.post(url, data);
    return response.data;
  }
}

步骤 4：在应用中使用适配器

// app.ts
import { HttpAdapter } from "./HttpAdapter";
import { AxiosAdapter } from "./AxiosAdapter";

const http: HttpAdapter = new AxiosAdapter();

// 示例：获取用户数据
interface User {
  id: number;
  name: string;
}

async function fetchUser() {
  const user = await http.get<User>("/api/user/1");
  console.log(user.name); // 类型安全！
}

// 示例：提交数据
await http.post("/api/submit", { key: "value" });

3. 适配器模式的核心优势

1. 解耦：业务代码不直接依赖 Axios，更换库只需改适配器（如换成 Fetch API）。
2. 统一接口：所有 HTTP 调用通过 HttpAdapter 接口访问。
3. 类型安全：利用 TS 泛型确保输入/输出类型正确。

4. 进阶：替换底层实现（如改用 Fetch API）

export class FetchAdapter implements HttpAdapter {
  async get<T>(url: string): Promise<T> {
    const response = await fetch(url);
    return response.json() as Promise<T>;
  }

  async post<T>(url: string, data: any): Promise<T> {
    const response = await fetch(url, {
      method: "POST",
      body: JSON.stringify(data),
      headers: { "Content-Type": "application/json" },
    });
    return response.json() as Promise<T>;
  }
}

切换适配器只需一行：

// 只需修改此处即可切换 HTTP 库
const http: HttpAdapter = new FetchAdapter(); // 替代 AxiosAdapter

5. 使用场景扩展

• API 响应适配：转换后端数据格式为前端模型

  // 适配器内部转换示例
  get<T>(url: string): Promise<T> {
  return axios.get(url).then(res => transformData(res.data)); // 数据转换
  }

• 兼容不同 SDK：统一不同支付接口（PayPal / Stripe）

总结

1. 定义统一接口（如 HttpAdapter）
2. 实现具体适配器（如 AxiosAdapter/FetchAdapter）
3. 在业务代码中通过接口调用
4. 灵活切换底层实现，不污染业务逻辑

关键原则：业务代码只依赖抽象（接口），不依赖具体实现。

通过 Adapter 模式，你可以轻松管理第三方库的依赖，提升代码的可维护性和可测试性。