用途:这是一份类型系统设计原则,适用于设计类型、审查函数签名或在任何静态类型语言中写代码时使用,目标是让非法状态在编译期不可表示。
主要能力(文中列出的模式): 一、让非法状态不可表示。用和类型建模变体,如 TypeScript 的可辨识联合、Rust/Swift/Kotlin 的带载荷枚举、Scala 的密封类、Haskell/OCaml 的代数数据类型;不要用一堆可选字段建模状态,避免出现矛盾组合仍能通过编译。文中举例:{ completed: boolean; completedAt?: Date } 允许 completed: true 而 completedAt: undefined,可从 completedAt !== null 派生布尔值,或显式建模为 { kind: 'open' } | { kind: 'done'; at: Date }。 二、类型是构造而非限制。从想要的取值构建类型,而不是用检查从更松的类型里削出来;非空列表是头加尾,合法时间区间是起点加时长,不存在特权表示,选择无法构造非法值的形状。 三、品牌化语义基元。UserId 与 OrderId 底层都是字符串但不应互换,可用 newtype、opaque type、value class、phantom type、branded intersection 等,创建时校验一次,之后信任类型。 四、外部数据在解析前是无类型的。RPC 载荷、JSON、IPC 消息、CLI 参数、配置文件、环境变量、数据库行,都应在边界处有 parse 函数把非结构化输入转为类型化模型。 五、不要对类型系统撒谎。强制转换、不安全强转与绕过编译器的断言函数是潜在的运行时崩溃。 六、穷尽匹配交给编译器。对和类型做匹配时,新增变体未处理应导致编译失败,使用各语言惯用法(TypeScript 的 never 绑定、Rust 的无标注 match、Haskell 的 -Wincomplete-patterns、Kotlin 密封类匹配穷尽性)。 七、从权威模式派生类型。当 protobuf、OpenAPI、GraphQL 模式、数据库迁移或设计令牌定义形状时,从中派生而非手写平行类型。 八、只在出现部分性时加强类型。运行时断言、空检查、“这不该发生”的抛出标记了类型过弱的位置,把检查推入类型,然后停止。优先全函数:sum 空列表为 0 故收普通列表,head 空列表无答案故要求非空列表。
适用场景:任何带类型的语言;文中提到类似 typescript-best-practices 的技能会把原则落到具体语法。
限制:资料未提供具体安装命令、平台支持、收费方式或价格信息,暂未提供。