UUID 完全指南：版本区别、生成原理与应用场景

前端开发
👥 土豆丝团队
2026年7月16日 阅读时间：约 9 分钟

在软件开发中，唯一标识符（UUID）是不可或缺的基础组件。无论是数据库主键、会话标识、分布式系统中的消息 ID，还是文件命名，UUID 都扮演着重要的角色。然而，很多开发者对 UUID 的各个版本（v1、v3、v4、v5、v7）的区别和适用场景并不十分清楚，经常随意选择一个版本使用。本文将深入解析 UUID 的标准规范、各个版本的生成原理、优缺点对比，以及在不同场景下的最佳实践，帮助你做出更明智的技术选择。

一、什么是 UUID？

UUID（Universally Unique Identifier，通用唯一标识符）是一个 128 位的数字，用于在计算机系统中唯一标识信息。它的设计目标是在分布式系统中，无需中央协调机构就能生成唯一的标识符。

1.1 UUID 的格式

标准的 UUID 由 32 个十六进制数字组成，以连字符分为五段，形式如下：

xxxxxxxx-xxxx-Mxxx-Nxxx-xxxxxxxxxxxx

其中 M 表示版本号，N 表示变体号。UUID 的总长度为 36 个字符（含连字符）。

1.2 UUID 的版本

UUID 有多个版本，每个版本使用不同的生成算法：

  • 版本 1：基于时间和 MAC 地址
  • 版本 3：基于名字空间和 MD5 哈希
  • 版本 4：基于随机数
  • 版本 5：基于名字空间和 SHA-1 哈希
  • 版本 7：基于时间和随机数（新提案）

1.3 唯一性保证

UUID 的唯一性基于以下原理：

  • 足够大的地址空间：128 位可以表示约 3.4×10³⁸ 个不同的值
  • 合理的生成算法：结合时间、空间和随机性确保唯一性
  • 实际应用中碰撞概率极低，可以忽略不计

💡 趣闻：每秒生成 10 亿个 v4 UUID，持续 100 年，碰撞概率约为 50%。换句话说，在正常使用场景下，UUID 碰撞的概率比你被陨石击中的概率还低得多。

二、UUID v1 - 基于时间和 MAC 地址

UUID v1 是最早的 UUID 版本，它结合了时间戳和 MAC 地址来生成唯一标识符。

2.1 结构组成

UUID v1 由以下部分组成：

  • 时间戳低 32 位
  • 时间戳中 16 位
  • 版本号（4 位）+ 时间戳高 12 位
  • 变体号（2 位）+ 时钟序列（14 位）
  • 节点（48 位，通常是 MAC 地址）

2.2 优点

  • 保证时间上的有序性，可以按时间排序
  • 在同一台机器上生成的 UUID 绝对唯一
  • 可以从 UUID 中提取时间戳和 MAC 地址信息

2.3 缺点

  • 泄露 MAC 地址，可能带来隐私和安全问题
  • 在分布式系统中可能产生重复（时钟回拨等情况）
  • 不是完全随机的，可能被预测

三、UUID v4 - 基于随机数

UUID v4 是目前最常用的 UUID 版本，它完全基于随机数生成。

3.1 结构组成

UUID v4 的结构非常简单：

  • 122 位随机数
  • 4 位版本号（固定为 0100）
  • 2 位变体号（固定为 10）

3.2 优点

  • 完全随机，无法预测，安全性高
  • 实现简单，不需要任何外部信息
  • 不泄露任何信息，保护隐私
  • 是最通用、最广泛支持的 UUID 版本

3.3 缺点

  • 没有时间信息，无法按时间排序
  • 理论上存在碰撞的可能（尽管概率极低）
  • 在数据库中作为主键时可能导致索引碎片化

🔐 安全提示：生成 v4 UUID 时，一定要使用密码学安全的随机数生成器（CSPRNG）。在浏览器中使用 crypto.getRandomValues()，在 Node.js 中使用 crypto.randomUUID() 或 crypto.randomBytes()。不要使用 Math.random()，因为它的随机性不够。

四、UUID v3 和 v5 - 基于名字空间

UUID v3 和 v5 都是基于名字空间和名称的确定性 UUID，相同的输入总是产生相同的输出。

4.1 基本原理

v3 和 v5 的生成方式相同，区别在于使用的哈希算法：

  • v3 使用 MD5 哈希算法
  • v5 使用 SHA-1 哈希算法

生成过程：将名字空间 UUID 和名称拼接，然后进行哈希，取前 128 位并设置版本和变体位

4.2 标准名字空间

RFC 4122 定义了几个标准名字空间：

DNS:  6ba7b810-9dad-11d1-80b4-00c04fd430c8
URL:  6ba7b811-9dad-11d1-80b4-00c04fd430c8
OID:  6ba7b812-9dad-11d1-80b4-00c04fd430c8
X.500: 6ba7b814-9dad-11d1-80b4-00c04fd430c8

五、UUID v7 - 新一代时间排序 UUID

UUID v7 是新的 UUID 版本提案（RFC 9562），结合了时间排序和随机性的优点。

5.1 结构组成

UUID v7 的结构：

  • 48 位时间戳（毫秒级 Unix 时间）
  • 4 位版本号（0111）
  • 12 位随机数 A
  • 2 位变体号（10）
  • 62 位随机数 B

5.2 优点

  • 时间有序，可以按时间排序，适合数据库索引
  • 包含足够的随机性，不可预测
  • 不泄露 MAC 地址，保护隐私
  • 在分布式系统中表现优秀

5.3 缺点

  • 相对较新，各语言的库支持还在完善中
  • 时钟回拨时需要特殊处理

🚀 趋势：UUID v7 正在快速普及，它结合了 v1 的时间有序性和 v4 的随机性，解决了数据库索引碎片化的问题。如果你正在设计新系统，强烈考虑使用 v7 作为主键方案。

六、各版本对比与选型建议

让我们对比一下各个 UUID 版本的特点，帮助你做出选择。

特性 v1 v3 v4 v5 v7
时间有序 ✅ ❌ ❌ ❌ ✅
随机性 部分 ❌ ✅ ❌ ✅
确定性 ❌ ✅ ❌ ✅ ❌
隐私安全 ❌ ✅ ✅ ✅ ✅
广泛支持 ✅ ✅ ✅ ✅ 发展中

6.2 如何选择

  • 大多数场景：使用 v4，简单、安全、通用
  • 需要时间排序：使用 v7，新一代标准
  • 需要提取时间和 MAC：使用 v1（注意隐私）
  • 需要确定性：使用 v5（比 v3 更安全）

七、最佳实践与常见问题

在实际使用 UUID 时，有一些最佳实践值得遵循。

7.1 存储优化

  • 使用二进制（16 字节）存储而非字符串（36 字节）
  • 在数据库中作为主键时，考虑使用有序 UUID（v1 或 v7）
  • 不区分大小写，可以统一转换为小写

7.2 生成注意事项

  • 使用密码学安全的随机数生成器（对于 v4）
  • 注意时钟回拨问题（对于 v1 和 v7）
  • 使用成熟的库，不要自己实现

7.3 常见误区

  • 误区：UUID 绝对不会重复 —— 正确说法：碰撞概率极低，但不为零
  • 误区：v4 不安全 —— 正确说法：v4 使用足够的随机熵，是安全的
  • 误区：字符串形式的 UUID 性能差 —— 正确说法：大多数场景下影响可以忽略

八、使用土豆丝 UUID 生成器

土豆丝工具提供了便捷的 UUID 生成功能：

🆔

UUID 生成器

v1 / v3 / v4 / v5 / v7 多版本支持

土豆丝工具的 UUID 生成器支持多个版本的 UUID 生成，包括 v1（时间+MAC）、v3（名字空间+MD5）、v4（随机数）、v5（名字空间+SHA-1）、v7（时间+随机数）。支持批量生成、自定义名字空间、大小写格式转换。所有生成都在浏览器本地完成，数据不会上传服务器。

多版本支持 批量生成 自定义命名空间 本地运行
立即使用 →

九、总结

UUID 是软件开发中最基础也最重要的工具之一。了解各个版本的特点和适用场景，可以帮助我们在不同场景下做出最合适的选择。v4 因其简单、安全、通用而成为大多数场景的首选；v7 作为新一代标准，在需要时间有序性的场景中表现出色；v3 和 v5 则适用于需要确定性的特殊场景。

在实际应用中，除了选择合适的 UUID 版本，还需要注意存储优化、生成安全等最佳实践。随着技术的发展，UUID v7 正在被越来越多的系统采纳，它结合了 v1 的时间有序性和 v4 的随机性，是一个很有前景的新标准。

土豆丝工具的 UUID 生成器支持多个版本的 UUID 生成，可以帮助你快速生成各种格式的 UUID，是开发和测试时的得力助手。

UUID 唯一标识符 分布式系统 前端开发 数据库