第33章 内置工具类型Partial与Required

案例问题/题目

设计一个用户信息编辑场景:管理员可以查看完整用户信息,但普通用户只能编辑部分字段。利用 Partial<T> 实现“可选编辑”,利用 Required<T> 实现“提交时必填校验”,并演示两者的组合转换。

设计思路

定义 User 接口后,使用 Partial<User> 作为更新参数类型,使得调用方可以只提供部分属性;使用 Required<Omit<User, 'id'>> 作为提交数据的校验类型,确保除 id 外的所有字段均被填满。最后通过两个模拟函数展示类型转换带来的编译期保障。

核心代码

interface User {
  id: number;
  name: string;
  email: string;
  age: number;
  active: boolean;
}

// ① Partial:可选编辑字段
function updateUser(id: number, patch: Partial<User>): void {
  console.log(`更新用户 ${id}:`, patch);
}
updateUser(1, { name: '张三' }); // ✅ 仅修改姓名
// updateUser(1, { id: 999 }); // ❌ id 不在 Partial 中?实际上在,但逻辑上不应允许

// ② Required + Omit:提交时必填(排除 id)
type SubmitUser = Required<Omit<User, 'id'>>;
function submitUser(data: SubmitUser): void {
  console.log('提交完整用户数据:', data);
}
submitUser({ name: '李四', email: 'li@example.com', age: 25, active: true }); // ✅
// submitUser({ name: '王五' }); // ❌ 编译错误:缺少必填属性

// ③ 组合:从 Partial 到 Required 的转换
type CompleteUser = Required<Partial<User>>; // 结果:所有属性必填,但 id 也在其中
const full: CompleteUser = { id: 1, name: '赵六', email: 'zhao@example.com', age: 30, active: false };
console.log('完整必填用户:', full);

运行结果验证

控制台输出依次为:更新用户 1: { name: '张三' }、提交完整用户数据: {…}、完整必填用户: {…}。若取消注释被标记为 ❌ 的代码,编译阶段即报错,从而验证类型保护生效。

测试建议

尝试用 Partial 传入空对象(合法但无意义),或使用 Required<Partial<T>> 强制所有字段必填,观察类型推断如何随转换变化。

注意事项

Required<T> 会递归移除所有可选标记,但不会自动检查运行时值是否存在——它仅是编译期约束。实际项目中仍应配合运行时校验(如 zod 或手写校验函数)。
成功要点:理解类型映射机制——Partial 将每个属性变为可选,Required 则反向操作。两者结合可灵活控制表单编辑与提交的不同阶段类型要求。