类型系统纪律(Type System Discipline)是一套面向静态类型语言的原则性技能,适用于设计类型、审查函数签名或编写代码的场景。其核心观点是:类型检查器就是证明助手,应当用它把不可能状态、混用的原始类型和未处理的变体在编译期消除;任何被当作运行期数据放行的内容,都可能变成编译器本可阻止的运行期故障。该技能适用于任何类型化语言,具体语法可由 typescript-best-practices 等技能落地。
主要模式包括:
一、让非法状态不可表示。用和类型建模变体:TypeScript 的可辨识联合、Rust/Swift/Kotlin 的带载荷枚举、Scala 的密封类、Haskell/OCaml 的代数数据类型。不要把状态建模成一堆可选字段,让互相矛盾的组合也能通过编译。文中点出一个微妙反模式:{ completed: boolean; completedAt?: Date } 允许 completed: true 而 completedAt: undefined,这毫无意义。应从单一来源派生布尔值(如 completedAt !== null),或显式建模为 { kind: 'open' } | { kind: 'done'; at: Date }。如果某个 bug 让人追问“等等,这种组合真的可能发生吗?”,说明类型太松。
二、为语义原始类型加品牌。UserId 和 OrderId 底层都是字符串,但不应可互换。可用 Rust 的 newtype、Swift 的不透明类型、Kotlin 的值类、Haskell 的幻影类型、TypeScript 的品牌交叉类型。在创建时验证一次,下游信任类型。
三、外部数据在被解析前都是无类型的。RPC 载荷、JSON、IPC 消息、CLI 参数、配置文件、环境变量、数据库行都属此类。应在每个边界设置解析函数,把非结构化输入转为类型化模型;验证位置可参考 boundary-discipline 原则技能。
四、不要欺骗类型系统。强制转换、不安全强制和绕过编译器的断言函数都是等待发生的运行期崩溃。如果编译器无法证明某个事实,就去证明它(验证、收窄、细化模型),或承认该转换是隐患。今天埋下的转换,就是下周要写的复盘。
五、穷尽匹配是编译器的职责。对和类型做匹配时,若新增变体未被处理,编译器必须让编译失败。使用各语言惯用法:TypeScript 的 never 类型绑定、Rust 的不带注解 match、Haskell 的 -Wincomplete-patterns、Kotlin 的密封类匹配穷尽性。
六、从权威模式派生类型。当 protocol buffer、OpenAPI 规范、GraphQL schema、数据库迁移或设计系统 token 文件定义了形状时,应从中派生,而不是手写一份平行类型。手工重复会漂移,可参考 encode-lessons-in-structure 原则技能。
七、优先编译期而非运行期。每个运行期断言、空值检查和 instanceof 都在承认类型系统没有承担应有职责,应把检查上推到类型层。
该技能还给出若干自测问题:能否写注释解释这组字段何时有效?若能,类型太松,应拆成和类型。两个函数参数是否共享原始类型却含义不同?应加品牌。这个 any、as、assertNotNull 从哪来?应追溯到边界并在那里验证。下个月新增变体时,编译器会告诉下一个智能体在哪里加分支吗?若不会,匹配就不穷尽。这个类型是否在重复另一个文件拥有的形状?应改为派生。