当前位置：首页 > 文章列表 > 文章 > 前端 > JS生成UUID的4种方法及实现详解

JS生成UUID的4种方法及实现详解

2025-06-27 21:18:18 0浏览收藏

“纵有疾风来，人生不言弃”，这句话送给正在学习文章的朋友们，也希望在阅读本文《JS生成UUID的4种方法及实现详解》后，能够真的帮助到大家。我也会在后续的文章中，陆续更新文章相关的技术文章，有好的建议欢迎大家在评论留言，非常感谢！

JavaScript中生成UUID的常见方法有crypto.randomUUID()（推荐，原生支持但兼容性差）、Math.random()（简单但唯一性差）、第三方库uuid（符合标准但需依赖）、基于时间戳和随机数（简单但非标准）。选择方案需根据项目需求权衡。UUID标准长度为36位，但可有其他表示形式。分布式系统中可通过UUID版本1、中心化服务或Snowflake算法保证唯一性。

js如何生成UUID字符串 4种前端生成唯一标识符方案

UUID，也就是通用唯一识别码，在JavaScript中生成主要用于生成唯一的ID，避免数据冲突或者标识特定元素。前端生成UUID的方案有很多，这里就介绍几种常见且实用的方法。

解决方案

使用crypto.randomUUID() (推荐)

这是目前最推荐的方式，因为它是原生支持的，无需依赖任何第三方库。

const uuid = crypto.randomUUID();
console.log(uuid); // 例如: 36ca5550-d70c-42e0-af88-7c117088d303

优点：

原生支持，无需引入额外依赖。
性能较好。
符合UUID标准。

缺点：

兼容性问题，并非所有浏览器都支持。

使用Math.random()生成简易UUID

这种方法虽然简单，但是唯一性不如前两种好，适用于对唯一性要求不高的场景。

function generateUUID() {
  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function(c) {
    var r = Math.random()*16|0, v = c == 'x' ? r : (r&0x3|0x8);
    return v.toString(16);
  });
}

const uuid = generateUUID();
console.log(uuid); // 例如: a2c7b1b2-2b3c-4b4a-b8b6-9c8d7e6f5a4c

优点：

简单易懂，代码量少。
兼容性好，几乎所有浏览器都支持。

缺点：

唯一性较差，在高并发场景下可能出现重复。
生成的UUID并非标准的UUID格式。

使用第三方库 (例如: uuid)

uuid是一个流行的JavaScript库，专门用于生成UUID。

首先，你需要安装这个库：

npm install uuid

然后，你可以这样使用它：

import { v4 as uuidv4 } from 'uuid';

const uuid = uuidv4();
console.log(uuid); // 例如: 1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed

优点：

生成的UUID符合标准。
提供了多种UUID版本 (v1, v3, v4, v5)。
使用广泛，社区支持良好。

缺点：

需要引入额外的依赖。
相对于原生方法，性能可能略有下降。

基于时间戳和随机数生成UUID

这种方法结合了时间戳和随机数，可以生成较为唯一的ID。

function generateUUID() {
  const timestamp = new Date().getTime().toString(16);
  const random = Math.random().toString(16).substring(2);
  return timestamp + random;
}

const uuid = generateUUID();
console.log(uuid); // 例如: 18d7a2f1b345a0.87654321

优点：

无需外部库依赖。
相对简单。

缺点：

唯一性依赖于时间戳和随机数，在高并发情况下可能出现重复。
生成的ID并非标准的UUID格式。

如何选择最适合你的UUID生成方案？

选择合适的UUID生成方案取决于你的具体需求。如果你的项目对唯一性要求非常高，并且可以接受引入第三方库，那么uuid库是最佳选择。如果你的项目对性能要求较高，并且运行环境支持crypto.randomUUID()，那么原生方法是首选。如果你的项目只是需要一个简单的ID，并且对唯一性要求不高，那么使用Math.random()或者基于时间戳和随机数的方法也是可以的。

UUID的长度一定是36位吗？

严格来说，标准UUID的字符串表示形式是36个字符，包含了32个十六进制数字以及4个连字符。但实际上，UUID的本质是一个128位的数字，它可以有多种不同的表示形式。在某些情况下，为了节省存储空间或者方便传输，可能会使用其他形式的UUID表示，例如去除连字符，或者使用Base62编码等。因此，UUID的长度并不总是36位，这取决于具体的应用场景和需求。

如何保证生成的UUID在分布式系统中的唯一性？

在分布式系统中，保证UUID的唯一性是一个重要的挑战。为了解决这个问题，可以考虑以下几种方法：

使用UUID版本1： UUID版本1基于时间戳和MAC地址生成，可以保证在不同的机器上生成的UUID是唯一的。但是，这种方法可能会暴露MAC地址，存在安全风险。
使用中心化的UUID生成服务： 可以搭建一个中心化的UUID生成服务，所有的机器都从这个服务获取UUID。这种方法可以保证UUID的全局唯一性，但是需要考虑服务的可用性和性能。
使用Snowflake算法： Snowflake算法是一种分布式ID生成算法，可以生成全局唯一的、递增的ID。这种算法需要依赖一个中心化的协调服务，例如ZooKeeper。

选择哪种方法取决于你的具体需求和系统架构。如果你的系统对性能要求较高，并且可以接受一定的复杂性，那么Snowflake算法是一个不错的选择。如果你的系统对安全性要求较高，并且可以接受引入中心化服务，那么使用中心化的UUID生成服务也是一个可行的方案。

好了，本文到此结束，带大家了解了《JS生成UUID的4种方法及实现详解》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！

UUID