开发 首页 工具

UUID / ULID 生成与解析工具

生成 UUID v1、v4–v7 与 Nil/Max,以及 ULID、NanoID、TypeID、ObjectId、KSUID、xid;解析报出类型与版本、还原内嵌时间,全部在本地完成。

← 全部工具

生成设置

结果

解析

标识符的定位

UUID v1100ns 时间 + 节点;节点位常是网卡 MAC。
UUID v4122 位纯随机,无顺序含义;通用默认。
UUID v5命名空间 + 名称的 SHA-1;输入相同则值相同。
UUID v6与 v1 同源,时间高位在前,字典序即时间序。
UUID v748 位毫秒时间 + 随机位,适合作数据库主键。
Nil / Max全零 / 全 F 两个常量,表示「没有值」与比较上界。
ULID48 位时间 + 80 位随机,字典序即时间序。
NanoID21 字符短 ID,无时间含义,适合对外短标识。
TypeID小写前缀 + UUIDv7,前缀自带可读的类别信息。
ObjectIdMongoDB 主键:秒级时间 + 进程随机 + 自增计数器。
KSUID秒级时间(纪元 2014-05-13)+ 16 字节随机。
xid秒级时间 + 机器号 + 进程 + 计数器;不是密码学安全。

随机部分来自加密安全随机数(xid 的机器号、进程与计数器是例外,可预测);UUID 与 ULID 中的时间是生成时刻本身,不指向设备或个人。

常见问题

UUID v4 与 UUID v7 应该选哪个?

只需要「唯一且不可预测」就用 v4,它是纯随机值,不带任何时间信息。希望标识符大体按生成时间递增(数据库主键、日志排序、按时间归档)就选 v7:它以 48 位毫秒时间戳开头、后接随机位。两者长度与书写格式完全相同,可以整库互换。

为什么 ULID 能按时间排序?

ULID 的前 10 个字符编码了 48 位毫秒级 Unix 时间戳,其余 16 个字符是随机数,两段都以 Crockford Base32 书写。这种字母表的字符顺序与数值顺序一致,所以直接对字符串做字典序比较(包括数据库默认的字符串排序)就等于按生成时间比较,不需要解析或额外字段。UUID v7 也有同样的性质。

NanoID 为什么比 UUID 短?

UUID 固定写 36 个字符(32 个十六进制字符加 4 个连字符),每个十六进制字符只携带 4 位信息。NanoID 默认 21 个字符、用 64 个字符的字母表(大小写字母、数字、连字符、下划线),每个字符携带 6 位信息,所以更短还能装下与 UUID 相当的随机位数。NanoID 也可以换用更小的字母表换更短的 ID,但随机位数下降,碰撞概率随之上升。

生成的标识符包含隐私信息吗?

不包含。UUID v4 与 NanoID 来自加密安全的随机数;UUID v7 与 ULID 内嵌的时间戳只是生成时刻,不指向任何设备或个人。早期的 UUID v1 会把网卡 MAC 地址写进末段,这一点在 v4/v7 里不存在。但标识符不泄露隐私不等于可以随意公开:能被枚举的 ID 仍可能被遍历访问,访问控制要另行实现。

重复概率怎么算?

用生日问题的近似:从 n 位随机的 ID 里取 k 个,出现至少一次碰撞的概率约为 k² ÷ 2^(n+1)。UUID v4 有 122 位随机,生成约 2.7 × 10^18 个才有五成概率撞车;NanoID 默认 126 位随机与之同量级。日常规模下重复概率远小于一次硬件故障,可以按唯一处理,并把兜底交给主键约束。

拿它们做数据库主键有什么建议?

优先选时间有序的 UUID v7 或 ULID:新纪录落在索引右侧,批量插入与缓存都更友好;UUID v4 随机分布会让索引频繁跨页写入,大批量插入明显变慢。定下一种格式后整库统一;UUID 可存 36 字符文本或 16 字节二进制(后者更省空间),ULID 存 26 字符文本。唯一性交给主键约束兜底,不要依赖应用层「先查有没有重复」。

UUID v1 与 v6 里的时间是哪种时间?

两者都把时间写成 60 位、单位 100ns 的计数,纪元是 1582-10-15(格里高利历),所以同一毫秒内还能再分出一万步。字段上限 2^60−1 大约落在 5236 年(RFC 9562 的勘误 8288 纠正过一处把年份写反的表述)。v1 把时间低 32 位放在最前,v6 改成高位在前,于是 v6 的字节序比较就等于时间比较。

Nil UUID 与 Max UUID 是什么?

Nil 是 32 个 0,约定表示「没有值」;Max 是 32 个 f,用来做区间上界(例如查询「小于某值」时的哨兵)。两者都是常量,不含随机位,也不能当作唯一标识使用。

哪些标识符是密码学安全的?

UUID v4、UUID v7、ULID、NanoID、TypeID 与 KSUID 的随机部分都来自加密安全随机数,值不可预测。两处例外:xid 的机器号、进程号与计数器是顺序可推的;UUID v1 的节点位在多数实现里会是真实网卡 MAC 地址——随机节点会把该字段首字节的组播位置 1(首字节十六进制最后一位是奇数),据此可以分辨。做令牌、会话或密钥时用前一类,并且不要用 UUID v3:它的 MD5 已可高效构造碰撞。

TypeID 的前缀有什么用?

前缀把「这是哪类对象」直接写在值里(如 user_、order_item_),日志、URL 与截图里一眼能读出类别,不用回头查表。前缀只能用 1–63 个小写字母与下划线、且首尾必须是字母,换成别的字符串就是完全不同的值。后半段就是 UUIDv7,所以 TypeID 同样按时间递增。