JavaScript / TypeScript / 系统课时

组合联合与交叉类型

组合联合与交叉类型

联合类型和交叉类型用于组合已有类型:联合类型表示一个值可以属于多种类型中的任意一种,交叉类型则要求一个值同时满足多种类型。本课将通过类型收窄和结构合并掌握两者的使用边界。

学习目标

  • 使用联合类型表达多种合法取值
  • 通过类型收窄安全访问不同类型的成员
  • 使用交叉类型合并多个对象结构

声明联合类型

联合类型使用 | 连接多个类型。变量只能赋值为联合成员之一,函数处理该变量时,只能直接使用所有成员共同拥有的能力。

ts
type OrderStatus = "pending" | "paid" | "closed";

function statusText(status: OrderStatus): string {
  if (status === "pending") {
    return "待支付";
  }
  if (status === "paid") {
    return "已支付";
  }
  return "已关闭";
}

console.log(statusText("paid"));

预期输出

text
已支付

字面量联合类型适合状态、模式和固定选项。与普通 string 相比,它能在编译阶段阻止拼写错误,例如 "payd" 不属于 OrderStatus。

使用类型收窄

当联合成员的结构不同,需要先判断当前值属于哪一种类型,再访问专有成员。常见收窄方式包括 typeof、in、相等判断和可辨识字段。

ts
type ApiResult =
  | { success: true; data: string }
  | { success: false; error: string };

function printResult(result: ApiResult): void {
  if (result.success) {
    console.log(`数据:${result.data}`);
  } else {
    console.log(`错误:${result.error}`);
  }
}

printResult({ success: true, data: "保存成功" });
printResult({ success: false, error: "权限不足" });

预期输出

text
数据:保存成功
错误:权限不足

这里的 success 是可辨识字段。判断后,TypeScript 会自动确定当前分支的具体类型,因此无需类型断言。设计业务联合类型时,优先加入值固定且名称一致的判别字段。

声明交叉类型

交叉类型使用 & 连接多个类型。结果必须同时拥有所有成员要求的属性,适合把基础信息、权限信息或审计信息组合成完整模型。

ts
type BasicUser = {
  id: number;
  name: string;
};

type PermissionInfo = {
  roles: string[];
  enabled: boolean;
};

type AdminUser = BasicUser & PermissionInfo;

const admin: AdminUser = {
  id: 1,
  name: "Alice",
  roles: ["admin", "auditor"],
  enabled: true
};

console.log(`${admin.name}: ${admin.roles.join(",")}`);

预期输出

text
Alice: admin,auditor

如果缺少任意一侧要求的属性,赋值都会失败。交叉类型不是“二选一”,而是“同时满足”。

理解冲突与组合方式

交叉类型合并同名属性时,属性类型也必须同时成立。例如 { id: string } & { id: number } 的 id 会变成无法正常赋值的 never。出现这种冲突通常说明模型设计不一致,应统一字段含义或重命名,而不是强行断言。

联合类型适合输入可能不同、状态存在分支和返回结果有多种形态的场景;交叉类型适合从多个稳定职责中组装完整对象。一个模型既有公共字段又有分支字段时,可以把公共结构与联合类型组合。

ts
type BaseEvent = {
  id: string;
  createdAt: string;
};

type EventDetail =
  | { type: "login"; ip: string }
  | { type: "payment"; amount: number };

type AppEvent = BaseEvent & EventDetail;

const event: AppEvent = {
  id: "evt-1",
  createdAt: "2026-08-02T07:41:00+08:00",
  type: "payment",
  amount: 88
};

console.log(`${event.type}: ${event.id}`);

预期输出

text
payment: evt-1

这种写法让公共字段只定义一次,同时保留不同事件的精确分支约束。

本课总结

  • 联合类型用 | 表示多个可能值中的任意一个
  • 类型收窄用于安全访问联合成员的专有属性
  • 交叉类型用 & 表示同时满足多组类型要求

下一课预告

下一课将继续学习类型别名与接口的选择,理解它们在复用对象结构和扩展模型时的差异。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

组合联合与交叉类型

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通