The Concise TypeScript Book 精读：TypeScript 映射类型（Mapped Types）完整实战指南

文档教程【免费下载链接】typescript-bookThe Concise TypeScript Book: A Concise Guide to Effective Development in TypeScript. Free and Open Source.项目地址https://gitcode.com/gh_mirrors/typ/typescript-book点击查看免费下载本篇指南以开源书籍The Concise TypeScript Book的「매핑된 타입映射类型」章节为骨架系统讲解如何借助keyof运算符与[P in keyof T]映射语法基于现有类型批量生成新类型并延伸覆盖readonly、?等映射修饰符、键重映射Key Remapping以及Partial、Readonly等内置工具类型的底层实现原理。读完本文你将能够独立编写可复用的映射类型工具并理解 TypeScript 类型系统「从类型生成类型」的核心机制。什么是映射类型以keyof为起点TypeScript 的映射类型Mapped Types允许你通过一个映射函数遍历并转换现有类型的每一个属性从而基于已有类型派生出新类型。核心思想是同一份信息可以用完全不同的结构形态来表达。创建映射类型的固定语法由两部分组成keyof T取出类型T的所有属性名构成一个字符串字面量联合类型[P in keyof T]遍历该联合类型将每一个属性名绑定到类型变量P上并在值位置引用T[P]取得原属性的类型。如果把keyof T视作属性名的集合那么[P in keyof T]就是在类型层面做一次循环对每个P按规则产出新类型。这与索引签名Index Signature的语法[key: string]: T相似但用途不同——索引签名是为未知的键定义取值类型可参见书中 타입 인덱싱类型索引 章节而映射类型是针对已知的键集合逐个变换属性。核心示例把每个属性转换为数组原文档给出的示例完整演示了映射类型的最小可用形态type MyMappedTypeT { [P in keyof T]: T[P][]; }; type MyType { foo: string; bar: number; }; type MyNewType MyMappedTypeMyType; const x: MyNewType { foo: [hello, world], bar: [1, 2, 3], };逐行拆解这段代码type MyMappedTypeT声明了一个接收类型参数T的泛型别名keyof T得到foo | bar[P in keyof T]依次令P取foo与bar映射出两个新属性T[P][]表示原属性类型的数组string[]与number[]于是MyNewType展开后等价于{ foo: string[]; bar: number[] }最终x对象必须为每个属性提供数组值编译期即可校验。这个示例的价值在于直观地展示了同一信息、不同结构MyType中foo是单个字符串而MyNewType中foo变成字符串数组——数据语义相同承载结构不同。这正是映射类型在真实项目中最重要的用途在不重复手写属性列表的前提下为既有领域模型批量生成配套结构。映射类型修饰符readonly与?原文档配套的「매핑된 타입 수정자映射类型修饰符」章节mapped-type-modifiers.md指出映射类型可以通过修饰符在遍历时同时变换属性的性质修饰符含义readonly或readonly将映射出的属性标记为只读-readonly移除只读标记使属性可变更?将映射出的属性标记为可选对应的三个经典工具类型定义如下type ReadOnlyT { readonly [P in keyof T]: T[P] }; // 所有属性标记为只读 type MutableT { -readonly [P in keyof T]: T[P] }; // 所有属性标记为可变更 type MyPartialT { [P in keyof T]?: T[P] }; // 所有属性标记为可选这里有三点值得注意readonly与readonly等价只是显式表达添加修饰符的写法对应地-前缀表示移除修饰符?放在T[P]之前表示属性可选其语义与普通接口中的name?: string完全一致修饰符只改变属性的可读写性 / 可选性不改变其类型本身因此T[P]部分可以原样保留。由于映射类型可以自由组合遍历规则与修饰符一个典型实践是先加只读、再加可选的分层封装type ReadonlyPartialT { readonly [P in keyof T]?: T[P] };键重映射Key Remapping用as子句改造属性名除了变换属性值的类型与修饰符映射类型还支持通过as子句重映射属性名本身。书中 exploring-the-type-system.md 的示例展示了如何结合模板字面量类型给每个键加前缀type JType { [Property in keyof Type as prefix_${string Property}]: () Type[Property]; }; type X { a: string; b: number; }; type Y JX;type Y JX得到的新类型等价于{ prefix_a: () string; prefix_b: () number }。这里的string Property写法是为了满足模板字面量类型对拼接片段必须是string类型的要求keyof理论上可能包含number或symbol键。通过重映射可以进一步用条件类型做键过滤——例如只保留满足特定约束的键——这是实现Pick、Omit类工具的关键技巧。需要注意的是书中也强调类型断言as不会执行多余属性检查因此当对象结构已知时优先使用类型声明而非断言。内置工具类型的映射本质理解了映射语法后会发现 TypeScript 标准库中大量常用工具类型本质上都是映射类型的应用。书中 type-manipulation.md타입 조작 章节列举了完整清单其中与映射类型关系最直接的有type PartialT { [P in keyof T]?: T[P] }; // 全部可选 type RequiredT { [P in keyof T]-?: T[P] }; // 全部必填 type ReadonlyT { readonly [P in keyof T]: T[P] }; // 全部只读 type RecordK extends keyof any, T { [P in K]: T }; // 键集 K 映射为 T例如PartialPerson的结果就是{ name?: string | undefined; age?: number | undefined; }ReadonlyPerson则会让a.name John这样的赋值在编译期直接报错。也就是说只要掌握了[P in keyof T]这一条语法Partial、Required、Readonly、Record、Pick、Omit等工具的构造思路都可以被理解并复刻。书中 predefined-conditional-types.md 章节则补充了Exclude、Extract、ReturnType、Parameters等基于条件类型的预定义类型二者共同构成从类型生成类型的完整工具箱。在 The Concise TypeScript Book 中的位置与延伸阅读映射类型是本书类型操作知识链路的中间环节其前后章节安排如下第 34 章 타입 인덱싱类型索引索引签名与T[K]索引访问是理解T[P]的基础第 38 章 매핑된 타입映射类型本文主题第 39 章 매핑된 타입 수정자映射类型修饰符readonly/?修饰符第 61 章 타입 조작类型操作将映射类型、条件类型、索引访问类型与全部内置工具类型汇总为一个整体视图。英文原版对应内容见 book/mapped-types.md 与 book/type-manipulation.md。按书中 목차目录 的顺序依次阅读可以建立从索引访问、映射类型到条件类型、工具类型的完整认知闭环。小结映射类型是 TypeScript 类型编程三大支柱映射、条件、模板字面量之一它以[P in keyof T]为统一入口实现结构变换这一最基础的类型派生能力。配合readonly、?、-修饰符以及as键重映射足以覆盖批量只读化、批量可选化、批量加前缀等绝大多数实战场景而标准库中Partial、Required、Readonly、Record等工具类型的底层实现正是这些语法的直接运用。建议在阅读本章后动手用映射类型重写一两个工具类型以加深对keyof、索引访问与修饰符组合的理解。赞分享文档教程【免费下载链接】typescript-bookThe Concise TypeScript Book: A Concise Guide to Effective Development in TypeScript. Free and Open Source.项目地址https://gitcode.com/gh_mirrors/typ/typescript-book点击查看免费下载相关推荐《The Concise TypeScript Book》精读Mapped Types 映射类型完全指南《The Concise TypeScript Book》精读Mapped Types 映射类型完全指南 映射类型Mapped Types是 TypeSc文档教程The Concise TypeScript Book 精读TypeScript 映射类型Mapped Types原理与实战The Concise TypeScript Book 精读TypeScript 映射类型Mapped Types原理与实战 映射类型Mapped Ty文档教程The Concise TypeScript Book映射类型Mapped Types实战指南The Concise TypeScript Book映射类型Mapped Types实战指南 映射类型是 TypeScript 类型系统中最强大的类型变文档教程上一篇通达信缠论可视化插件终极指南让技术分析变得简单快速下一篇ExcelJS 工作簿对象模型Workbook Model完全指南数据结构、单元格类型与模型读写创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考