Go标准库不提供UUID v4生成函数，推荐使用google/uuid包；因其轻量、符合RFC 4122且默认用crypto/rand保证加密安全，避免math/rand导致的线程不安全、重复ID及位设置错误等问题。
Go 标准库不直接提供 UUID v4 生成函数，必须借助第三方包或手动实现；推荐使用 google/uuid，它轻量、符合 RFC 4122、且默认使用加密安全的随机源。
为什么不用 math/rand 手动生成 UUID v4？
UUID v4 要求 128 位中特定位置（第 13 位字节的高 4 位）固定为 0100（即版本号 4），且第 17 位字节的高 2 位必须是 10（变体标识）。手写容易错位、漏掩码、或误用非加密随机源——这会导致碰撞概率远高于理论值（1/2¹²²），尤其在高并发或容器化部署时更危险。
-
math/rand不是线程安全的，未显式设置 seed 时所有 goroutine 共享默认 seed，可能产出重复序列 - 手动拼接字节切片时，易把 byte index 算错（例如把第 13 字节当成索引 12 还是 13）
- 忽略变体字段（
byte[16] & 0xc0 == 0x80）会导致生成的字符串不符合 v4 规范，某些系统校验失败
用 google/uuid 生成合规 v4 字符串
该包的 uuid.NewRandom() 内部调用 crypto/rand.Read()，自动处理版本位与变体位，返回的 uuid.UUID 值可直接转为标准格式字符串。
import "github.com/google/uuid" id := uuid.NewRandom() // 返回 uuid.UUID 类型 s := id.String() // 自动格式化为 xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx
- 无需手动 import
crypto/rand或管理 seed -
uuid.NewRandom()在首次调用时初始化一次随机源，后续复用，性能无明显损耗 - 若需批量生成，直接循环调用即可，每个 ID 都独立且合规
- 注意：不要用
uuid.NewUUID()（已弃用），它依赖math/rand且不保证加密安全性
需要兼容 Go 1.20+ 的 crypto/rand 原生方案？
Go 1.20 引入了 crypto/rand.Numeric 的便捷封装，但 UUID v4 仍需手动置位。以下是最简合规实现：
立即学习“go语言免费学习笔记（深入）”；
import (
"crypto/rand"
"fmt"
)
func newUUIDv4() string {
b := make([]byte, 16)
rand.Read(b) // 使用 crypto/rand，安全
b[6] = (b[6] & 0x0f) | 0x40 // 版本位设为 4
b[8] = (b[8] & 0x3f) | 0x80 // 变体位设为 10xx
return fmt.Sprintf("%x-%x-%x-%x-%x", b[0:4], b[4:6], b[6:8], b[8:10], b[10:])
}
- 必须用
rand.Read()，不能用rand.ReadFull()（后者返回 error，需额外判断） - 字节索引从 0 开始：
b[6]是第 7 字节，对应 UUID 字符串中第 13 个 hex 字符（即版本位所在位置） -
fmt.Sprintf中的分段长度要严格匹配：4-2-2-2-6，否则格式非法 - 该函数比
google/uuid略快（少一层封装），但失去包内已验证的边界处理和测试覆盖
真正关键的不是“怎么生成”，而是“是否每次生成都满足 RFC 4122 第 4.4 节对 v4 的位级约束”。哪怕只漏一个 & 0x0f 掩码，生成的字符串就只是“看起来像 UUID”的随机字符串，不是合规 v4。
