类型编程:从问题到类型计算

用整体模型连接已有机制,围绕完整案例学习,把语法细节留作查阅。

本章目录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 的代码尤其只描述契约,不提供可执行实现。

这一页,先记到这里。