生成器

UUID 生成器

生成各版本的 UUID/GUID

生成的 UUID0 个
点击"生成"按钮生成 UUID

什么是 UUID?

UUID(Universally Unique Identifier,通用唯一识别码)是一种软件构建的标准,用于在分布式系统中唯一标识信息。UUID 由 32 个十六进制数字组成,以连字符分隔为五组,形式为 8-4-4-4-12。

支持的类型

  • UUID v4(随机):最常用的版本,基于随机数生成,碰撞概率极低
  • UUID v1(时间):基于时间戳和机器 MAC 地址生成
  • NanoID(短码):更短的唯一 ID,URL 友好,适合前端使用

使用场景

  • 数据库主键:作为分布式系统的唯一标识
  • 会话 ID:用户会话的唯一标识
  • 文件命名:上传文件的唯一文件名
  • 请求追踪:微服务架构中的请求链路追踪

格式选项

  • 大写:将所有字母转为大写形式
  • 无连字符:移除中间的连字符,生成 32 位连续字符串

生成 UUID 形态的标识符(8-4-4-4-12 分组):v4 随机、前 12 位为 Unix 毫秒时间戳的 v1 样式、21 字符短 ID;可设条数、大小写和连字符,适合做主键草稿与测试数据。

36 个字符里哪几位是固定的

UUID 是 128 位,写成 32 个十六进制位、按 8-4-4-4-12 分五组共 36 个字符。有 6 位不随机:第 13 位是版本号,v4 写 4、v1 写 1;第 17 位是变体位,生成器把最高两位置为 10,故只能是 8、9、a、b。这 6 位定值让 v4 只剩 122 位随机。RFC 9562(2024 年 5 月)取代 RFC 4122 但布局未变:第 13 位不是合法版本、或第 17 位不以 10 开头,即为伪造,严格校验器先查的就是这两处。

为什么 v1 选项不是 RFC v1

这一模式不读网卡地址:取 Date.now() 的毫秒值转十六进制、左补零到 12 位,再按 8-4 切段,前 8 位是时间戳的高 32 位,后 4 位是低 20 位。高位在前,所以按字典序排就等于按毫秒时间排序。真正的 v1 用从 1582 年 10 月 15 日起算的 100 纳秒计数,分段顺序不同,末尾还要接 14 位时钟序列和 48 位节点(历史上即网卡 MAC)。因此这里不泄露硬件地址,但标准 v1 解析器重组出的时间会是错的年份。

随机字符从哪来

三种模式都用 Math.random() 取字符。V8 里它是 xorshift128+,只返回 53 位精度:重复概率低,但不是密码学安全随机源,输出够多时状态可被反推。测试数据、缓存键、追踪 ID 够用;会话 ID、重置链接、邀请码应改用 crypto.randomUUID() 或 crypto.getRandomValues()(后者需安全上下文)。NanoID 从 0-9A-Za-z 取 21 个字符,62^21 约 2^125,与 v4 相当却只用 21 个字符。

实操示例

固定毫秒下的 v1 样式输出

输入
v1 模式,1 条,小写,保留连字符,Date.now() = 1759234567890
输出
01999a8d-2ed2-11f9-aadd-373963fcd6e9

前 12 位十六进制就是时间戳本身:01999a8d2ed2 等于 1759234567890,即 2025-09-30T12:16:07.890Z,紧跟其后的 1 是版本位。其余字符由 Math.random() 生成,故只有前 13 个字符可复现;去掉连字符后正好 32 个字符。

边界与常见误用

  • 所有 ID 都由 Math.random() 产生,它不是密码学安全随机源,不能当作会话令牌、重置密码链接或 API key 使用。
  • v1 模式没有 48 位节点、没有 14 位时钟序列,也不从 1582 年起按 100 纳秒计时,所以标准 v1 解析器会把它的时间字段读错。
  • 条数默认 5,输入框限定 1 到 100;max 只是浏览器侧校验,生成循环本身并不截断。
  • NanoID 输出是 21 个 0-9A-Za-z 字符,不是 128 位 UUID,uuid 类型的数据库列(32 位十六进制)会直接拒绝。
  • 大写与去连字符是按此顺序对成品字符串做的后处理,去掉连字符后是 32 字符的 N 形式,要求 36 字符格式的校验规则会判定不合法。

相关工具

三种模式定不下来的五个判断

你要做的事本页的 UUID 生成器更该换的东西
只是给测试夹具或种子文件造几十个一次性 ID打开页面列表里已经有 5 条;改条数、点生成、点复制全部,换行分隔的一整段直接粘进 YAML 或 CSV 的某一列。不用装东西也不用跑命令,这就是这页存在的场合。超过一批就别再手点了:node -e "for(let i=0;i<500;i++)console.log(crypto.randomUUID())" 一次输出 500 行,形态同样是 36 个字符,随机源换成了操作系统的 CSPRNG 而不是 Math.random()。别去掉连字符,夹具才能原样互换。
主键必须按写入先后排出来v1 模式把当前毫秒值的十六进制塞进前 12 位,所以对字符串排序就等于按时间排序。代价在同一毫秒:同毫秒内生成的两条,前 12 位和紧跟的 1 完全一样,后面全是随机数,谁先谁后毫无信息量。如果顺序是表结构层面的硬要求而不只是顺眼,就在程序里生成 RFC 9562 v7 或 ULID:两者都保留 48 位毫秒前缀,尾部由系统随机源填充,同毫秒的记录仍能稳定分出先后,重试写入也不靠运气。这页留给根本不按顺序查的键。
ID 要放进邀请链接,21 个字符太长NanoID 模式固定 21 个字符、取自 0-9A-Za-z,页面上没有任何长度控件。62^21 约合 2^125;自己截到 8 位,只剩约 2^47.6、也就是 2.2×10^14 量级——做能公开分享的短码绰绰有余,做不能被猜的东西远远不够。改用 nanoid 包,把长度当参数传进去(nanoid(10)),而不是事后截断;它读的也是 crypto,本页这个短 ID 模式并不是。只对「被猜到也只损失一次点击」的值做缩短。
值要交给 uuid 类型的列或严格的校验器选 v4:生成器把第 13 位写成 4、把第 17 位限定在 8、9、a、b,这正好是校验器最先查的两处。v1 模式的轮廓一模一样,所以形状检查能过,但它把毫秒计数放在 RFC v1 该放 100 纳秒间隔的位置。对端真的会解析版本和时间戳时,就别用仿制品:uuidgen、Python 的 uuid.uuid1(),或 uuid 包的 v7。本页只适合把字符串当不透明字节处理的消费方。
同样的输入每次都要得到同一个 ID这里没有基于名字的模式,只有 v4、v1 样式和 NanoID 三个开关,每次点生成都从新的随机数重建整批。做主键时这正是你要的;做缓存键、去重令牌或需要重复导入的表时,它只会静默地造出重复行。用 v5(命名空间 + 名字,SHA-1):uuid 包的 v5() 或 Python 的 uuid.uuid5()。天生确定,第二次导入算出同样的 36 个字符,upsert 也就不会把行数翻倍。

一个具体场景

三百个内测邀请码,栽在「大写」那个勾上

给内测发 300 个邀请码,选 NanoID 模式、默认 21 个字符:300 条就是 6300 个字符,塞进 CSV 完全不占地方,体积不是问题。问题在「大写」勾选框——它作用在生成结果上,而 NanoID 取的字母表是 62 个区分大小写的符号,一勾实际只剩 36 个,单码空间从 62^21(约 2^125)掉到 36^21(约 2^108.6)。2^108 仍然猜不出来,代价落在兼容性上:已经按原样发出去的混合大小写邀请码,在 Postgres 大小写敏感的列里再也查不到,两个只差大小写的码也会变成同一个字符串。所以 NanoID 保持小写;真想要 12 位,去 nanoid 包里把长度当参数,62^12 约 2^71。

常见问题

随机生成的 UUID(v4)有多高的唯一性?
v4 携带 122 个随机位。生成约 2^61 个 UUID 后,出现任意碰撞的概率仍只有约十亿分之一——在实际使用中可以视为不会重复。
应该选哪个版本的 UUID?
通用场景用 v4。如果把 ID 用作数据库主键或需要按时间排序索引,优先 v7(时间有序):随机 v4 作为主键会在高并发插入时打散 B 树索引。
能把 UUID 缩短后放进 URL 吗?
可以。把它还原为 16 字节再用 Base64URL 编码,36 个字符可缩到 22 个。注意保持 URL 安全编码,解码时按 Base64URL 还原字节即可得到原 UUID。

内容复核: