用途:在设计与审查类型、审阅函数签名或编写任意静态类型语言代码时,应用该原则让非法状态无法表示,使编译器承担拒绝不可能状态、不匹配原始类型与未处理变体的职责。
主要能力:一是为语义化原始类型加“品牌”(brand),例如 UserId 与 OrderId 底层虽都是字符串,但不应可互换,需各自独立类型,如 TypeScript 中的 branded intersection 或其他语言中的 newtype;在创建时校验一次,下游信任该类型。若两个参数共享原始类型但含义不同,也应加品牌。二是把外部数据视为未类型化直到解析:RPC 载荷、JSON、IPC 消息、CLI 参数、配置文件、环境变量、数据库行等,都应在每个边界处有解析函数,把非结构化输入转为类型化模型。三是当 protobuf、OpenAPI 规范、GraphQL schema、数据库迁移、设计令牌文件等权威模式拥有某个形状时,应从其派生类型,而不是手工维护一份平行类型。
使用方式:作为设计原则应用于类型定义与函数签名审查;TypeScript 语法细节参考 typescript-best-practices 技能;验证位置参考 boundary-discipline 原则技能;结构编码参考 encode-lessons-in-structure 原则技能。
适用场景:任何静态类型语言的建模、接口设计与代码评审,尤其是存在多个同底原始类型参数、需处理外部输入边界或已有权威 schema 的项目。
限制:资料未提供具体代码示例、支持语言清单、安装命令、收费或效果数据,暂未提供。