第32章 映射类型

案例 32:映射类型——让接口属性一键可选或只读

在业务开发中,常需要根据同一份数据模型派生出不同场景的变体:表单编辑时所有字段可选,展示时所有字段只读。手写重复接口费时且易错,TypeScript 的映射类型可优雅解决。

设计思路

借助内置工具类型 Partial<T> 和 Readonly<T>,它们本质是通过索引签名遍历属性并附加修饰符。为加深理解,我们手动实现这两个工具,并组合出“可选+只读”的最终形态。

核心代码

// 原始接口
interface User {
  name: string;
  age: number;
  email: string;
}

// 手动实现 Partial(所有属性可选)
type MyPartial<T> = { [K in keyof T]?: T[K] };

// 手动实现 Readonly(所有属性只读)
type MyReadonly<T> = { readonly [K in keyof T]: T[K] };

// 组合:可选 + 只读
type OptionalReadonly<T> = { readonly [K in keyof T]?: T[K] };

// 应用
type OptionalUser = MyPartial<User>;
type ReadonlyUser = MyReadonly<User>;
type BothUser = OptionalReadonly<User>;

// 验证
const u1: OptionalUser = { name: "张三" }; // 只给部分属性
const u2: ReadonlyUser = { name: "李四", age: 30, email: "a@b.com" };
// u2.name = "王五"; // 编译错误:只读
const u3: BothUser = { age: 25 }; // 完全自由
console.log(u1, u2, u3);

运行结果

编译无错误,控制台输出三个对象。若取消注释 u2.name = ...,TypeScript 会立即报错,验证只读约束生效。

成功要点

掌握了 keyof T 遍历对象键、? 和 readonly 修饰符在映射类型中的放置位置,就理解了 TypeScript 工具类型的核心原理。

测试建议

尝试修改 MyPartial 的键为 readonly 前缀,观察既有可选又有只读的效果;或对嵌套对象使用 DeepPartial 递归映射。

注意事项

映射类型不会对原始接口产生副作用,返回的是新类型。但注意 readonly 只限制编译期赋值,运行时对象仍可变。

运行验证

使用 npx tsc mapping.ts && node mapping.js 执行,无报错且输出三个对象即为成功。