不能用 math/rand 自己拼 UUID,因其无法满足 RFC 4122 对 v4 版本的比特位要求(如第13位为0、17–20位为1000),易出错且通不过标准校验;应使用 github.com/google/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 字节定义,无需手动调整字节序。
立即学习“go语言免费学习笔记(深入)”;
在高并发场景下频繁调用 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) 存原始字节数组以节省空间和提升索引效率。










