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 环境变量类型,让项目在严格模式下继续保持可检查的导入边界。
按自己的节奏,确认真正理解。