用途:在设计类型、审查函数签名或编写任意静态类型语言代码时应用,让编译器拒绝不可能状态、不匹配的原始类型和未处理的变体。倾向把错误与特殊情况定义到不存在,而非堆叠处理器。TypeScript 语法参见 typescript-best-practices 技能。
主要能力:
- 让非法状态无法表示。用和类型(可辨识联合、带载荷的枚举、密封类)建模变体,而非一堆可选字段。例如 { completed: boolean; completedAt?: Date } 允许 completed: true 却没有日期;可从 completedAt 派生布尔值,或建模为 { kind: 'open' } | { kind: 'done'; at: Date }。
- 类型是构造而非限制。从想要的值构建类型,而非用检查从宽松类型中削出。非空列表是头加剩余;有效时间范围是起点加时长。
- 为语义原始类型加品牌。UserId 与 OrderId 底层都是字符串但不可互换,各自独立类型(TypeScript 用品牌交叉类型,其他语言用 newtype)。在创建时校验一次,下游信任类型。
- 外部数据在被解析前是无类型的。RPC 载荷、JSON、IPC 消息、CLI 参数、配置文件、环境变量、数据库行,都应在每个边界用解析函数转为类型化模型。边界放置参见 boundary-discipline 原则技能。
- 不要对类型系统撒谎。类型断言、不安全强转和绕过编译器的断言函数是潜在运行时崩溃。编译器无法证明的事,要么证明(校验、收窄、精化模型),要么承认强转是风险。
- 穷尽匹配是编译器的职责。对和类型的匹配在新变体未处理时必须编译失败,让编译器告诉下一个 agent 在哪补分支。用语言惯用法:TypeScript 的 never 绑定、Rust 的无标注 match、Haskell 的 -Wincomplete-patterns、Kotlin 的密封类匹配穷尽性。
- 从权威模式派生类型。当 protobuf、OpenAPI、GraphQL、数据库迁移、设计令牌文件等拥有形状时,从它派生,而非手写并行类型。
- 只在出现部分性处加强类型。运行时断言、空值检查或“这不该发生”抛错,标记了类型过弱之处,把检查上推到类型;然后停止。类型系统的职责是跟踪每个使用点必须处理的情况,而非尽可能精确描述数据。优先全函数:空列表求和为 0,故接受普通列表;空列表取头无答案,故要求非空列表。若原本不会有 panic,保留普通类型。
使用方式与适用场景:作为编码、审查与设计时的原则性指导,适用于任何静态类型语言项目。限制:面向 TypeScript 的具体语法需查阅 typescript-best-practices;是否提供安装命令、具体版本与收费信息暂未提供。