类型编程:从问题到类型计算
用整体模型连接已有机制,围绕完整案例学习,把语法细节留作查阅。
本章目录CONTENTS ↓
一个 API 已经声明了方法名、参数和返回值。如果调用记录还要手写另一份类型,方法变了,记录很容易漏改。能否把已有声明当作输入,计算出新的类型,并让编译器拒绝名称与参数错配的记录?这就是本课程要学习的类型编程。
课程围绕“需要表达什么关系 → 简单写法缺少什么 → 用什么类型机制补上 → 变换怎样求值 → 保证到哪里为止”展开。语法随着问题出现;这些推导解释机制的用途,不冒充语言设计者当年的历史动机。
学习成果是能读懂、推导、编写和调试类型表达式。需求分析、模块职责、程序结构和实现验证方法由独立的软件设计课程承接。这里仍用小段 JavaScript 说明静态与运行时的边界。
整体模型:信息、关系与边界
进入运算前,先读集合、子类型与结构类型,建立“来源是否满足目标要求”的方向感。它解释普通类型的包含关系,也指出 any、字面量检查和函数规则为何不能简单套用集合直觉。
| 层次 | 要回答的问题 | 核心理解 |
|---|---|---|
| 静态与运行时 | 编译器检查什么? | 类型描述执行前的约束,运行时行为仍由 JavaScript 决定。 |
| 数据与兼容性 | 一个值能否放到这里? | 对象通常按结构比较;方向决定哪些要求必须满足。 |
| 联合与收窄 | 当前还有哪些可能? | 联合表达候选,控制流排除候选,相关字段需要先在模型中关联。 |
| 泛型 | 哪些位置要一起变化? | 参数保存关联,约束限定范围,推导利用调用处的信息。 |
| 类型编程 | 怎样派生新的契约? | 从已有类型读取、构造、筛选、提取,再组合成目标结构。 |
| 类型表达的取舍 | 哪些关系值得编码? | 比较表达精度、可读性与检查成本。 |
联合 A | B 允许任一成员;交叉 A & B 要同时满足两侧要求,不能简单理解为覆盖式对象合并。这里运算的是符合类型的值集合:并集扩大候选范围,交集同时增加要求。字段为何看起来相反、联合如何展开,以及 keyof 的规则,见联合与交叉的值集合模型。
unknown 表示使用前需要检查的信息,never 表示没有可能值,any 会绕开许多检查。这些概念帮助判断信息如何保留或丢失。
类型标注和断言不会验证服务器响应,也不会把字符串转换成数字。外部数据的验证和实际数据转换需要运行时代码。参见官方 The Basics。
类型编程:把表达式读成变换过程
| 操作 | 常用工具 | 阅读时追踪什么 |
|---|---|---|
| 读取 | keyof T、T[K] |
读取的是键集合,还是对应的值类型? |
| 构造 | 映射类型、键重映射 | 每个键生成什么?哪些位置共享当前键? |
| 分支与筛选 | 条件类型、never | 判断整体还是逐成员?丢弃的是属性值还是整个成员? |
| 提取 | infer、Parameters、ReturnType | 从哪个结构位置取信息?配对是否保留? |
| 表达结构 | 元组、模板字面量 | 是否保留参数位置、数量或字符串组成关系? |
| 组合与递归 | 中间类型、递归条件类型 | 每步输入输出是什么?递归何时终止? |
把长表达式拆成几个有名字的中间结果,通常比直接盯住嵌套符号更有效。官方 Creating Types from Types 提供各工具的查阅入口。
一个贯穿案例:方法表变成合法命令
API 定义了方法名和参数,命令模型应该跟随这份定义,并拒绝名称与参数交叉配对。手写每种命令能表达关系,但每增添一个方法就要重复更新。只把所有名字和所有参数各自合成联合,又会允许错误组合。
因此需要依次做三件事:读取方法名,针对每个名字读取它自己的参数,最后把完整记录合成联合。下面先展示这条计算链的全貌;后续章节会分别推导每个操作,无需在这里记住全部符号。
type Api = { getUser: (id: number) => { name: string }; search: (query: string, limit?: number) => string[];};
type CommandMap = { [K in keyof Api]: { method: K; args: Parameters<Api[K]> }};type Command = CommandMap[keyof Api];
const valid: Command = { method: "getUser", args: [42] };// @ts-expect-error getUser 要求数字参数const invalid: Command = { method: "getUser", args: ["42"] };
function describe(command: Command): string { if (command.method === "getUser") return command.args[0].toFixed(0); return command.args[0].toUpperCase();}输入是 Api。keyof 读取名字,映射逐个选择 K,Parameters 提取该方法的参数元组,最后索引取出完整命令的联合。method 和 args 在同一个成员里配对,因此检查 method 能同步确定 args。
如果先把全部名字合成联合,再把全部参数合成另一个联合,重新拼成对象,就丢失了哪些参数属于哪个名字的信息。先建立配对,再允许选择,是状态、表单、事件和 API 用例反复使用的同一条设计原则。
这里生成静态命令类型,没有实现通用调用器,也没有校验外部 JSON。继续加入返回结果和非函数字段筛选,见API 测试用例建模。
按问题选择阅读路线
| 目的 | 组合阅读 | 应能解释 |
|---|---|---|
| 理解类型系统 | 联合与交叉 → 请求状态 → 收窄 → 泛型 | 数据有哪些可能,关系如何表示,检查后知道什么。 |
| 深入类型编程 | 字段变更 → API 用例 → 递归传输模型,回查映射、分配、infer | 每一步变换的输入输出,配对在哪里建立或丢失,递归何时终止。 |
| 设计函数 API | 事件 API → DOM 事件声明 → 函数包装,回查兼容性和可选参数 | 调用方允许做什么,名称精度怎样影响推导,实现必须满足什么。 |
| 生成字符串契约 | 字段名变成事件名 | 模板怎样构造名字,键重映射怎样保留原字段的值类型。 |
基础篇按依赖顺序从联合、判别与收窄进入泛型、映射、条件和提取,再补函数兼容性与可选参数。实战篇把这些机制组合为字段变更、事件、字符串、调用记录、包装和递归变换。一次围绕一个完整任务使用相关章节,不必按目录读完全部细节。
目前笔记覆盖核心建模、类型变换、同步函数 API、DOM 事件真实声明、直接 Promise 返回方法的筛选,以及有限业务对象的递归传输模型。React 声明阅读、异步结果类型和类型检查成本仍可按后续问题补充;完整异步流程与数据验证方案归入软件设计;DOM 和递归例子只覆盖各章注明的范围。
必须理解与按需查阅
需要内化的是静态/运行时边界、可赋值方向、联合中的关联、泛型保存信息的方式、条件分配和 infer 匹配结构的机制。具体工具清单、修饰符写法、重载细节和编译选项则允许查阅;深入理解不等于记住所有特殊求值结果。
| 遇到的问题 | 查阅入口与关键词 | 验证方法 |
|---|---|---|
| 联合为什么被拆开 | Distributive Conditional Types | 两个成员的小例子,比较逐成员与整体。 |
| 如何复用参数、返回值 | Parameters / ReturnType / Awaited | 查看展开类型,加入应接受与应拒绝的调用。 |
| 如何修改属性结构 | Mapped Types / Key Remapping | 先用两个字段检查键和值的变化。 |
| 回调为何不兼容 | More on Functions、strictFunctionTypes | 找目标允许而实现接不住的输入,或不满足承诺的输出。 |
| 库推导与预期不同 | 具体 API 声明、泛型参数与重载 | 跳转声明,缩小为一次调用,在项目实际选项下检查。 |
查资料时先定位规则类别,再找原始文档或库声明,最后让编译器验证最小例子。笔记里的类型通过检查不等于运行时逻辑已经正确;标有 declare 的代码尤其只描述契约,不提供可执行实现。
这一页,先记到这里。