JavaScript / TypeScript / 系统课时
组合联合与交叉类型
组合联合与交叉类型
联合类型和交叉类型用于组合已有类型:联合类型表示一个值可以属于多种类型中的任意一种,交叉类型则要求一个值同时满足多种类型。本课将通过类型收窄和结构合并掌握两者的使用边界。
学习目标
- 使用联合类型表达多种合法取值
- 通过类型收窄安全访问不同类型的成员
- 使用交叉类型合并多个对象结构
声明联合类型
联合类型使用 | 连接多个类型。变量只能赋值为联合成员之一,函数处理该变量时,只能直接使用所有成员共同拥有的能力。
type OrderStatus = "pending" | "paid" | "closed";
function statusText(status: OrderStatus): string {
if (status === "pending") {
return "待支付";
}
if (status === "paid") {
return "已支付";
}
return "已关闭";
}
console.log(statusText("paid"));预期输出
已支付字面量联合类型适合状态、模式和固定选项。与普通 string 相比,它能在编译阶段阻止拼写错误,例如 "payd" 不属于 OrderStatus。
使用类型收窄
当联合成员的结构不同,需要先判断当前值属于哪一种类型,再访问专有成员。常见收窄方式包括 typeof、in、相等判断和可辨识字段。
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: "权限不足" });预期输出
数据:保存成功
错误:权限不足这里的 success 是可辨识字段。判断后,TypeScript 会自动确定当前分支的具体类型,因此无需类型断言。设计业务联合类型时,优先加入值固定且名称一致的判别字段。
声明交叉类型
交叉类型使用 & 连接多个类型。结果必须同时拥有所有成员要求的属性,适合把基础信息、权限信息或审计信息组合成完整模型。
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(",")}`);预期输出
Alice: admin,auditor如果缺少任意一侧要求的属性,赋值都会失败。交叉类型不是“二选一”,而是“同时满足”。
理解冲突与组合方式
交叉类型合并同名属性时,属性类型也必须同时成立。例如 { id: string } & { id: number } 的 id 会变成无法正常赋值的 never。出现这种冲突通常说明模型设计不一致,应统一字段含义或重命名,而不是强行断言。
联合类型适合输入可能不同、状态存在分支和返回结果有多种形态的场景;交叉类型适合从多个稳定职责中组装完整对象。一个模型既有公共字段又有分支字段时,可以把公共结构与联合类型组合。
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}`);预期输出
payment: evt-1这种写法让公共字段只定义一次,同时保留不同事件的精确分支约束。
本课总结
- 联合类型用
|表示多个可能值中的任意一个 - 类型收窄用于安全访问联合成员的专有属性
- 交叉类型用
&表示同时满足多组类型要求
下一课预告
下一课将继续学习类型别名与接口的选择,理解它们在复用对象结构和扩展模型时的差异。