这个项目能做什么

go-branded-id 是一个提供带品牌标识、强类型标识符的 Go 库。它使用幻影类型在编译期防止不同实体 ID（例如 UserID 与 OrderID）相互混用，从而捕获那些原本可能被忽视的缺陷。该库的核心操作零分配，仅使用 Go 标准库，并支持完整序列化，包括 JSON、SQL、Text、Binary 和 Gob。它适用于任何可比较类型，提供零值语义（在 JSON 中序列化为 null，在 SQL 中为 nil），并包含 SQL scanner/valuer。具名品牌类型可提供 Name() 方法，用于生成调试可见的字符串以及品牌感知的校验。该库还提供用于错误处理的哨兵错误，以及一个用于生成 Name() 桩代码的 codemod 工具。它要求 Go 1.26+。