SuperAPI AI 工具集

principle-type-system-discipline

编程与开发

查看项目

更新于 11-19 03:05

技能介绍

类型系统纪律(Type System Discipline)是一项面向编程的原则技能,适用于设计类型、审查函数签名,或用任何静态类型语言编写代码的场景。其核心观点是:把类型检查器当作证明助手,在编译期消除不可能的状态、错配的原始类型和未处理的变体。类型允许你忽略的情况,最终会变成编译器本可阻止的运行时失败。与此相对的偏好是:把错误与特殊情况定义为不存在,而不是不断增殖处理器。

适用方式:该技能面向任何类型化语言,具体语法可结合《typescript-best-practices》等相关技能落地。

模式一:让非法状态无法被表示。用和类型建模变体,例如 TypeScript 的可辨识联合、Rust/Swift/Kotlin 的带载荷枚举、Scala 的密封类、Haskell/OCaml 的 ADT。不要把状态建模成一袋可选字段,让相互矛盾的组合也能编译通过。文档举例说明一个微妙的反模式:{ completed: boolean; completedAt?: Date } 允许 completed: true; completedAt: undefined,这是无意义的。应当从单一来源派生该布尔值(如 completedAt !== null),或显式建模为 { kind: 'open' } | { kind: 'done'; at: Date }。如果一个缺陷迫使你追问“等等,这种组合真的可能发生吗?”,说明类型太松。

模式二:类型是构造,不是限制。从你想要的取值向上构造类型,而不是从更宽松的类型中用检查切出来。看似需要精化类型的不变量,通常只差一次构造:非空列表是头加尾,不是带长度检查的列表;有效时间范围是起点加时长,不是两个必须保持有序的时间戳。没有任何表示是特权表示:一对对组成的列表,如果按那种方式解释,就是偶数长度列表;因此要选择无法构造出非法值的形状,并在其上暴露调用者所需的接口。

模式三:为语义原始类型打品牌。UserId 与 OrderId 底层都是字符串,但不应可互换。相关手段包括 Rust 的 newtype、Swift 的不透明类型、Kotlin 的值类、Haskell 的幻影类型、TypeScript 的品牌交叉类型。在创建时校验一次,下游信任该类型。

模式四:外部数据在被解析之前是无类型的。涉及 RPC 载荷、JSON、IPC 消息、CLI 参数、配置文件、环境变量、数据库行。在每个边界设置解析函数,把非结构化输入转换为类型化模型;边界校验的放置可参阅 boundary-discipline 原则技能。

模式五:不要对类型系统说谎。类型转换、不安全强制转换,以及绕过编译器的断言函数,都是潜在的运行时崩溃。如果编译器无法证明某个事实,就证明它(校验、收窄、精化模型),或者承认该转换是危险的。

模式六:穷尽匹配是编译器的职责。对和类型做匹配时,若新增变体未被处理,编译器必须导致编译失败。使用你所选语言的惯用法:TypeScript 的 never 类型绑定、Rust 的未标注 match、Haskell 的 -Wincomplete-patterns、Kotlin 的密封类匹配穷尽检查。

模式七:从权威模式派生类型。当 protobuf、OpenAPI 规范、GraphQL 模式、数据库迁移或设计系统 token 文件定义了一种形状时,从它派生,而不是手写一个平行类型;可参阅 encode-lessons-in-structure 原则技能。

模式八:仅在出现部分性(partiality)的地方强化类型。运行时断言、空值检查或“这不应发生”的抛出,标记了类型过弱的位置。把该检查上推到类型中,然后停止。类型系统的职责是跟踪每个使用点必须处理的情况,而不是尽可能精确地描述数据。偏好全函数:空列表求和为 0,所以它接受普通列表;空列表取头没有答案,所以它要求非空列表。

文末还给出若干自检问题,例如:能否写出注释解释这组字段何时有效?若能,说明类型太松,应拆成和类型。两个函数参数共享同一原始类型但含义不同吗?给它们打品牌。这个 any、as、assertNotNull 来自哪里?追溯到边界并在那里校验。下个月新增变体时,编译器会告诉下一个智能体在哪里添加分支吗?若不会,说明匹配不穷尽。这个类型是否重复了其他文件拥有的形状?应改为派生。我强化这个类型是为了让操作保持全函数,还是只是为了更精确?若本来不会 panic,就保留普通类型。