SuperAPI AI 工具集

principle-type-system-discipline

编程与开发

查看项目

更新于 11-01 16:53

技能介绍

用途

这是一套面向静态类型语言的类型系统设计原则,适用于三类场景:设计类型、审查函数签名、编写任何静态类型语言的代码。目标不是增加类型标注数量,而是用类型让编译期拒绝非法状态。

主要能力

让非法状态无法表示。 优先通过类型定义让错误与特殊情况不存在,而不是为每种情况编写处理分支。能消除的状态就不必写处理器。

给语义基元打品牌。 UserId 与 OrderId 底层都是字符串,但不应可互换。为每个赋予独立类型,例如 TypeScript 中的 branded intersection,其他语言中的 newtype。在创建时校验一次,下游信任类型。若两个参数共享同一基元类型却含义不同,就应打品牌。

外部数据在解析前一律视为未类型化。 包括 RPC 载荷、JSON、IPC 消息、CLI 参数、配置文件、环境变量、数据库行。在每个边界设置解析函数,把非结构化输入转换为类型化模型。校验放在哪里,可参考 boundary-discipline 原则技能。

从权威 schema 派生类型。 当 protocol buffer、OpenAPI 规范、GraphQL schema、数据库迁移、设计令牌文件或其他文件拥有某个形状时,从中派生类型,而不是手写一份平行类型。相关思路见 encode-lessons-in-structure 原则技能。

使用方式

该页面未提供具体安装命令或调用步骤。相关技能页面仅以原则条目形式给出指导,实际应用时按上述条目在设计、审查或编码过程中执行。TypeScript 具体语法请参考 typescript-best-practices 技能。

适用场景

  • 设计领域模型与类型定义;
  • 审查函数签名,发现语义相近但可互换的参数;
  • 接入外部数据边界(API、消息、配置、数据库)时确定解析与校验位置;
  • 已有权威 schema 时避免重复维护类型。

限制

  • 面向静态类型语言,动态类型语言需另行处理;
  • TypeScript 语法细节不在本技能内,需参阅 typescript-best-practices;
  • 校验位置的具体规则在 boundary-discipline 技能中;
  • 本页未提供安装方式、代码示例、收费信息或效果保证。