TypeScript类型别名：让数据库接口更清晰好维护

在写前端项目对接后端ref="/tag/1/" style="color:#643D3D;font-weight:bold;">数据库接口时，经常会遇到一长串结构复杂的返回数据。比如用户信息，可能包含 id、姓名、邮箱、注册时间，甚至嵌套的地址信息。每次写接口定义都要重复这些结构，时间一长，改一处就得翻好几处代码，特别容易出错。

类型别名是怎么帮上忙的

TypeScript 的类型别名（type alias）其实就是给某种类型起个新名字。这听起来简单，但在处理数据库相关数据结构时特别实用。比如，后端返回一个订单记录，里面包含用户信息、商品列表、支付状态等，我们可以把这些结构先用 type 定义出来。

type UserID = string;

type Address = {
  province: string;
  city: string;
  detail: string;
};

type User = {
  id: UserID;
  name: string;
  email: string;
  address: Address;
};

type Order = {
  orderId: string;
  user: User;
  items: { name: string; price: number }[];
  paid: boolean;
};

这样写完，以后只要看到 User 就知道是用户数据结构，不用再翻接口文档。而且如果哪天后端把 userId 从字符串改成数字，只需要改 UserID 这一行定义，所有用到的地方都会自动更新类型检查。

和接口（interface）有啥不一样

有人喜欢用 interface，但类型别名更灵活。比如联合类型就只能用 type 来定义。假设订单状态可能是待支付、已发货、已完成，可以用字符串字面量联合：

type OrderStatus = 'pending' | 'shipped' | 'completed';

type Order = {
  status: OrderStatus;
  updatedAt: string;
};

这种写法在处理数据库枚举字段时特别顺手，还能防止拼错状态值。

实际场景：处理 API 返回数据

比如调用一个获取用户订单历史的接口，返回的是数组。以前可能会直接写 Array<any>，但现在可以精确描述：

type ApiResponse = {
  success: boolean;
  data: Order[];
  message?: string;
};

// 使用 fetch 请求后
async function fetchOrders(): Promise<ApiResponse> {
  const res = await fetch('/api/orders');
  return res.json();
}

编辑器能立刻提示 data 里每个订单有哪些字段，写逻辑时不容易手滑写错 key 名。上线前 TypeScript 也会帮你检查有没有漏处理的情况。

类型别名不是炫技，而是让代码更贴近业务。尤其是多人协作项目，别人一看类型名就知道数据长什么样，不用反复确认字段含义。数据库字段变动时，改几个 type 定义就能同步全项目，省得满地找 magic string 和 any 类型擦屁股。