Vue / 系统课时

工具类型与类型组合

工具类型与类型组合

企业项目里的同一份业务模型,常常要同时服务于创建、更新、列表展示和权限映射。本课用一个用户模型演示 Partial、Pick、Omit、Record 的职责与组合方式,最终得到可复用、可校验、不过度复制接口的类型设计。

学习目标

  • 理解四种常用工具类型分别改变了类型的哪些部分
  • 能从主业务模型派生创建、更新和列表展示类型
  • 能识别工具类型组合中的失真与滥用问题

从主业务模型派生类型

工具类型不会修改原接口,而是在编译阶段生成新类型。企业项目应先维护一份字段完整、语义稳定的主模型,再按接口场景派生窄类型,避免多个相似接口长期漂移。

ts
interface User {
  id: number;
  name: string;
  email: string;
  role: "admin" | "editor" | "viewer";
  enabled: boolean;
  createdAt: string;
}

type CreateUserInput = Omit<User, "id" | "createdAt">;
type UpdateUserInput = Partial<Pick<User, "name" | "email" | "role" | "enabled">>;
type UserListItem = Pick<User, "id" | "name" | "role" | "enabled">;
type RoleLabelMap = Record<User["role"], string>;

const roleLabels: RoleLabelMap = {
  admin: "管理员",
  editor: "编辑者",
  viewer: "访客"
};

const update: UpdateUserInput = {
  name: "Alice",
  enabled: true
};

const row: UserListItem = {
  id: 1001,
  name: update.name ?? "未命名",
  role: "editor",
  enabled: update.enabled ?? false
};

console.log(`${row.id} ${row.name} ${roleLabels[row.role]} ${row.enabled}`);

将代码保存为 utility-types.ts 后执行:

bash
npx tsx utility-types.ts

预期输出:

text
1001 Alice 编辑者 true

四种工具类型的职责

Partial<T> 把 T 的全部属性变为可选,适合补丁式更新,但不适合直接代表“任意合法对象”。Pick<T, K> 只保留指定字段,适合列表项、表单步骤和接口投影。

Omit<T, K> 删除指定字段,常用于创建参数排除数据库生成字段。Record<K, V> 要求键集合完整且值类型统一,适合状态文案、权限映射和策略表;当联合类型新增成员时,编译器会提醒补齐映射。

组合顺序与关键边界

组合类型时先缩小字段范围,再改变可选性通常更安全。例如 Partial<Pick<User, ...>> 只允许更新白名单字段;直接写 Partial<User> 会把 id、createdAt 也开放给调用方,容易形成越权修改入口。

工具类型只约束编译阶段,不会验证接口返回的真实数据。来自 HTTP、缓存或本地存储的数据仍要经过运行时校验,再断言为业务类型。对于嵌套对象,Partial 只处理第一层;深层可选需要单独建模,不能误以为它会递归生效。

本课总结

  • 以稳定主模型为源头,通过工具类型派生场景模型,可以减少重复定义
  • 更新模型应先 Pick 白名单字段,再使用 Partial 放宽必填约束
  • Record 适合要求键集合完整的映射,但工具类型不能代替运行时数据校验

下一课预告

下一课将处理模块声明、第三方包缺失类型以及 Vite 环境变量类型,让项目在严格模式下继续保持可检查的导入边界。

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

目录与阅读设置

阅读设置

17

记录一个想法

工具类型与类型组合

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

登录哪都通