第34章 Pick与Omit工具类型

案例34:Pick与Omit工具类型——选择或排除指定属性

在TS中,我们经常需要从已有接口中提取或剔除部分属性,Pick和Omit正是为此而生。

设计思路

定义用户接口,用Pick提取公开信息(姓名+邮箱),用Omit排除敏感字段(密码+身份证)。最后用satisfies验证类型兼容性。

核心代码

interface User {
  id: number;
  name: string;
  email: string;
  password: string;
  idCard: string;
}

// Pick:只保留指定的属性
type PublicUser = Pick<User, "name" | "email">;

// Omit:排除指定的属性
type SafeUser = Omit<User, "password" | "idCard">;

const rawUser: User = {
  id: 1,
  name: "张三",
  email: "zhangsan@example.com",
  password: "123456",
  idCard: "110101200001011234",
};

// 安全输出:绝不含敏感字段
const publicInfo: PublicUser = {
  name: rawUser.name,
  email: rawUser.email,
};

// Omit结果包含 id/name/email,但不含 password/idCard
const safeInfo: SafeUser = {
  id: rawUser.id,
  name: rawUser.name,
  email: rawUser.email,
};

console.log("公开信息:", publicInfo);
console.log("安全数据:", safeInfo);

// 编译期验证:访问被排除的属性会报错
// @ts-expect-error 以下代码会导致编译错误,取消注释即可体验
// console.log(publicInfo.password);
黄色提示:Pick是“正向选择”,Omit是“反向排除”,两者都返回新类型,不修改原接口。
蓝色技巧:优先使用Pick声明最小依赖,避免把整个大接口传给函数。
红色警告:不要对联合类型使用Pick/Omit,应先通过Extract或Exclude处理。
绿色成果:代码通过tsc --noEmit编译,运行时控制台输出仅包含安全字段,敏感数据零泄露。

运行与验证

将代码保存为pick-omit.ts,执行ts-node pick-omit.ts或tsc pick-omit.ts && node pick-omit.js,可看到输出结果。

注意事项

① Pick要求属性名必须是联合类型字符串字面量;② Omit内部实现其实是Pick<T, Exclude<keyof T, K>>,理解这一点即可灵活组合。