订单号、用户 ID、上传文件的名字,到处都能见到一串带连字符的十六进制字符,那就是 UUID。记住一句话:UUID 是 128 位全局唯一标识,写成 8-4-4-4-12 的 36 个字符;数据库主键选 v7、一般随机 ID 选 v4、从名字稳定生成选 v3 或 v5。
UUID 的全称是 Universally Unique Identifier(通用唯一识别码),一种 128 位标识符,标准是 RFC 9562(2024 年 5 月发布,取代 2005 年的 RFC 4122)。它用 32 个十六进制字符表示,分 5 段,段间用连字符隔开,格式 8-4-4-4-12,连上连字符共 36 个字符,例如550e8400-e29b-41d4-a716-446655440000。设计目标是:不需要中央发号机构,任何人生成的 ID 都几乎不可能与别人的重复。
5 段不只是为了好看:其中两位数字标明了版本与变体,读懂这两位就能认出一个 UUID 是哪个版本。
| 段 | 长度 | 内容 |
|---|---|---|
| 第 1 段 | 8 位 | 时间戳或随机数 |
| 第 2 段 | 4 位 | 时间戳或随机数 |
| 第 3 段 | 4 位 | 首位是版本号:1 是 v1,4 是 v4,7 是 v7 |
| 第 4 段 | 4 位 | 首位是变体位:8、9、a、b 四种之一 |
| 第 5 段 | 12 位 | 节点标识或随机数 |
版本号在第 3 段首位,变体位在第 4 段首位:550e8400-e29b-41d4-a716-446655440000第 3 段以4开头就是 v4,第 4 段以a开头符合变体规则。主流变体位对应二进制10开头,即十六进制的 8、9、a、b。认版本看这两位就够了。
三个版本共用同一副外形,区别在 128 位里装了什么:v1 装时间与机器信息,v4 全装随机数,v7 前面装时间、后面装随机数。
| 版本 | 里面是什么 | 时间有序吗 | 随机位数 | 适用场景 |
|---|---|---|---|---|
| v1 | 60 位时间戳 + 节点标识 | 是 | 很少 | 老系统兼容 |
| v4 | 122 位随机数 | 否 | 122 位 | 通用随机 ID、请求 ID、临时标识 |
| v7 | 48 位毫秒时间戳 + 74 位随机数 | 是 | 74 位 | 新项目数据库主键 |
| v3/v5 | 名字 + 命名空间的哈希(MD5/SHA-1) | 否 | 由哈希定 | 同一个名字永远生成同一个 ID |
v1 的 60 位时间戳以 100 纳秒为单位,从 1582 年 10 月 15 日开始计,节点标识历史上是机器的 MAC 地址:能排序,但泄露时间与机器信息,只在老系统里见到。v4 的 122 位全是随机数,最简单、最常用。v7 是 RFC 9562(2024 年)的新版本:前 48 位是 Unix 毫秒时间戳,后 74 位是随机数,既随机、又让新 ID 自然排在旧 ID 后面。v3/v5 对“命名空间 + 名字”做哈希,同一个名字永远得到同一个 UUID。
选 v7。主键上通常有 B 树索引,新记录按主键顺序插入。v4 是纯随机数,新 ID 落在索引任意位置,索引页频繁分裂,写多了会变慢;v7 前 48 位是毫秒时间戳,新 ID 总排在旧 ID 后面,插入基本是顺序追加,对索引友好得多。PostgreSQL 18(2025 年 9 月)内置uuidv7(),Python 3.14 内置uuid7()。v4 适合一切不需要排序的场合。注意:v7 时间戳是明文,拿到 ID 就能读出生成时间精确到毫秒;不希望泄露时间信息时继续用 v4。
当同一个名字必须永远得到同一个 ID 时用。v3 对“命名空间 + 名字”做 MD5,v5 做 SHA-1,输入不变、输出永远不变,不用查表、不用存映射。选 v5 不选 v3:SHA-1 比 MD5 更安全,RFC 9562 也建议新实现优先用 v5。命名空间是区分用途的前缀,同一个名字挂在不同命名空间下会得到不同 UUID。v3/v5 不适合做随机 ID:输入可猜,输出就可猜;需要不可预测的 ID 时用 v4 或 v7。
MagiTool 的 UUID 生成器批量生成 UUID,点一下就能复制,全部在浏览器本地完成,数据不上传、不保存。生成前先想清楚版本:默认 v4,数据库主键用 v7,从名字稳定派生用 v5。选对版本比多生成几个更重要。
理论上会,实际上几乎不可能:v4 有 122 位随机数,日常使用中撞上的概率可以忽略不计。真正要担心的是生成器本身:随机数来源质量差(比如用了可预测的种子),再大的空间也没用。不要把 UUID 当密码或密钥:RFC 9562 明确提醒,不应假定 UUID 难以被猜到。
看第 3 段的首位:1 是 v1,4 是 v4,7 是 v7。例如 550e8400-e29b-41d4-a716-446655440000 的第 3 段是 41d4,首位是 4,所以是 v4。第 4 段的首位是变体位,主流取值是 8、9、a、b 四种之一。只看这两位就能认出版本,不用解析整串。
会。v7 的前 48 位就是 Unix 毫秒时间戳,任何人拿到 ID 都能读出它精确到毫秒的生成时间。不希望别人知道记录的创建时间,改用 v4。v1 也一样,还带机器信息,隐私问题比 v7 更大。
看场景。自增 ID 短、好读、天然有序,但需要中心发号,多台机器同时发号会撞。UUID 不需要协调,但更长、更难读、随机版本对索引不友好。单体应用够用就用自增;多服务、需要离线生成 ID 时用 UUID,数据库主键优先选 v7。
没有。十六进制字符不区分大小写,A 与 a 是同一个值。规范写法是小写,大多数工具与数据库也输出小写。比较或去重时先统一转成小写,避免 550E8400-... 与 550e8400-... 被当成两个 ID。
能。去掉连字符后是 32 位十六进制字符串,很多系统用这种形式存 UUID。标准写法带连字符,两种写法互相转换不丢信息。入库前先定一种形式,别混用。