在软件开发中经常需要生成唯一标识符UUID。例如用户 ID订单号文件唯一标识API 请求 ID分布式系统对象 ID在 Go 语言生态中最常用、最稳定的 UUID 库之一是github.com/google/uuid该库由 Google 维护广泛应用于各种 Go 项目中。一、什么是 UUIDUUIDUniversally Unique Identifier是一种通用唯一标识符。标准由 Internet Engineering Task ForceIETF定义。UUID 通常是一个128 位数字常见字符串格式为550e8400-e29b-41d4-a716-446655440000结构形式8-4-4-4-12例如xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxUUID 的核心特点全球唯一不依赖中心服务器可以离线生成适合分布式系统二、google/uuid 库介绍github.com/google/uuid是 Go 官方生态中最常用的 UUID 库之一。主要特点API 简洁生成速度快支持多个 UUID 版本维护稳定生产环境广泛使用支持的 UUID 类型UUID v1时间 MAC 地址UUID v3基于 MD5UUID v4随机UUID v5基于 SHA1其中使用最多的是UUID v4随机 UUID。三、安装库在 Go 项目中安装go get github.com/google/uuid导入包import github.com/google/uuid四、生成随机 UUID最常用UUID v4 是随机生成的 UUID也是使用最多的一种。示例代码package main import ( fmt github.com/google/uuid ) func main() { id : uuid.New() fmt.Println(id) }输出示例c4d61c4a-1d9f-4c62-b7c8-2d8b7a9e89d1每次运行都会生成不同的 UUID。五、UUID 转字符串如果需要保存到数据库或返回 API可以转换为字符串。id : uuid.New() str : id.String() fmt.Println(str)输出3d2a9b0b-45fd-4e8c-9c35-d2f5e8d93a12六、解析 UUID如果接收到字符串形式的 UUID可以解析为 UUID 类型。idStr : 550e8400-e29b-41d4-a716-446655440000 id, err : uuid.Parse(idStr) if err ! nil { panic(err) } fmt.Println(id)解析成功后可以继续使用。七、生成 UUID v1UUID v1 基于时间戳和 MAC 地址生成。示例id, err : uuid.NewUUID() if err ! nil { panic(err) } fmt.Println(id)特点可排序含时间信息包含机器标识但存在隐私问题因此使用不如 v4 常见。八、基于名称生成 UUIDUUID v3 和 v5 是基于名称生成的。适用于相同输入生成相同 UUID数据去重哈希标识示例id : uuid.NewSHA1(uuid.NameSpaceDNS, []byte(example.com)) fmt.Println(id)同样输入将得到相同 UUID。九、判断 UUID 是否为空可以检查 UUID 是否为零值。var id uuid.UUID if id uuid.Nil { fmt.Println(UUID 为空) }uuid.Nil 表示00000000-0000-0000-0000-000000000000十、数据库存储建议在数据库中存储 UUID 时通常有两种方式方式一字符串长度36 字符例如varchar(36)优点可读性好调试方便方式二二进制UUID 实际是16 bytes数据库可以存储为BINARY(16)优点占用空间小查询更快十一、典型应用场景UUID 在很多系统中都有应用例如用户唯一 ID 订单编号 文件 ID 日志追踪 ID 微服务请求 ID 分布式对象 ID例如requestID : uuid.New().String()用于 API 日志追踪。十二、性能情况UUID v4 的生成速度非常快。在 Go 中每秒可以生成几十万到上百万个 UUID。因此完全适合高并发系统分布式服务微服务架构十三、常见问题UUID 是否绝对唯一理论上不是绝对唯一但概率极低。UUID v4 的随机空间是2^122几乎不可能重复。UUID 是否可以排序普通 UUID v4 不可排序。如果需要排序可以使用UUID v1或时间排序 ID例如 Snowflake。十四、总结github.com/google/uuid 是 Go 生态中最常用的 UUID 生成库之一。主要优点官方背景稳定API 简洁性能优秀支持多种 UUID 版本在 Go 项目中如果需要生成唯一 ID使用该库可以非常快速地实现稳定可靠的 UUID 方案。它也是构建分布式系统、微服务架构和高并发系统时的重要基础组件之一。