Golang生成UUID方法及uuid库使用教程

本文深入解析了在 Go 语言中正确生成符合 RFC 4122 标准的 v4 UUID 的最佳实践，明确指出绝不能依赖 `math/rand` 手动拼接——因其无法保证关键比特位（如第13位为0、17–20位为1000）而必然导致非标和校验失败；推荐使用经过严格验证的 `github.com/google/uuid` 库，详解 `uuid.New()`（推荐）与 `uuid.NewUUID()` 的等价性、无连字符格式的正确输出方式（如 `fmt.Sprintf("%x", id)`）、高并发下的性能表现（缓冲优化，无需担忧），并提醒数据库存储时的类型选择陷阱（如 PostgreSQL 原生 uuid 类型或 MySQL 的 BINARY(16) 更优），助你避开常见坑点，写出安全、标准、高效且可维护的 UUID 相关代码。

为什么不用 math/rand 自己拼 UUID？

直接用随机数生成字符串再加连字符，看似简单，但会破坏 UUID 的标准结构和版本语义。比如 v4 要求特定比特位固定（如第 13 位必须是 0，第 17–20 位必须是 1000），自己拼容易出错，且无法通过标准校验。官方 github.com/google/uuid 库已严格实现 RFC 4122，包括熵源安全、字节序处理、版本标记等细节。

uuid.NewUUID() 和 uuid.New() 有什么区别？

这两个函数功能完全一致，uuid.New() 是 uuid.NewUUID() 的别名，从 v1.3.0 起推荐使用 uuid.New()。它们都生成一个随机的 v4 UUID，并返回 uuid.UUID 类型值（本质是 [16]byte）。

package main

import (
    "fmt"
    "github.com/google/uuid"
)

func main() {
    id := uuid.New() // 推荐写法
    fmt.Println(id.String()) // 输出类似：f47ac10b-58cc-4372-a567-0e02b2c3d479
}

如何生成不带连字符的 UUID 字符串？

uuid.UUID 提供了多个格式化方法：.String() 带连字符，.URN() 带 urn:uuid: 前缀，而 .String()[0:8] + ... 手动切片易出错。正确做法是用 .EncodeToString() 配合 uuid.Hex 编码器，或更简单——直接调用 .String()[0:8] + ... 并不推荐；实际应使用 id.String() 后用 strings.ReplaceAll，但最稳妥的是用 fmt.Sprintf("%x", id)。

• id.String() → "f47ac10b-58cc-4372-a567-0e02b2c3d479"
• fmt.Sprintf("%x", id) → "f47ac10b58cc4372a5670e02b2c3d479"（全小写十六进制，无分隔符）
• fmt.Sprintf("%X", id) → 全大写

注意：%x 输出顺序符合 UUID 字节定义，无需手动调整字节序。

在高并发场景下频繁调用 uuid.New() 会影响性能吗？

不会。该函数内部使用 crypto/rand.Read()，但做了缓冲和复用优化；实测在普通服务中每秒数万次调用毫无压力。真正要注意的是：不要在循环里反复 import 或重复构建全局依赖。另外，若你只需要唯一 ID（不要求标准 UUID 格式），可考虑 uuid.Must(uuid.NewRandom())，但没必要——uuid.New() 本身已 panic-safe，失败时返回零值并记录 error，生产环境建议显式检查：

id, err := uuid.NewRandom()
if err != nil {
    log.Fatal(err) // 或按需处理
}

不过日常用 uuid.New() 就够了，它底层就是封装好的 uuid.NewRandom() 加错误转零值逻辑。

容易被忽略的一点：如果你把 UUID 存进数据库，注意字段类型是否支持 36 字符（含连字符）或 32 字符（纯 hex）；PostgreSQL 有原生 uuid 类型，MySQL 建议用 CHAR(36) 或 BINARY(16) 存原始字节数组以节省空间和提升索引效率。

今天带大家了解了的相关知识，希望对你有所帮助；关于Golang的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~