JavaScript中创建GUID/UUID的方法

JavaScript中创建GUID/UUID的方法

技术背景

在JavaScript开发中,有时需要生成全局唯一标识符(GUID)或通用唯一识别码(UUID)。GUID/UUID是一种由数字和字母组成的标识符,通常为32或36个字符,用于确保在全球范围内的唯一性。这些标识符在数据库、分布式系统、网络通信等领域有着广泛的应用。然而,JavaScript本身并没有直接提供生成GUID/UUID的内置方法,因此需要开发者自己实现或使用第三方库。

实现步骤

1. 使用crypto.randomUUID()

在现代浏览器和JS运行时中,crypto.randomUUID()是生成RFC4122-compliant UUID的标准方法。但该方法仅适用于本地(localhost或127.0.0.1)或通过HTTPS提供服务的页面。

1
2
const uuid = crypto.randomUUID();
console.log(uuid);

2. 使用uuid模块

对于旧版平台或非安全上下文,uuid模块是一个不错的选择。它经过了充分的测试和支持,可以生成不同版本的UUID。
安装:

1
npm install uuid

使用示例:

1
2
3
const { v4: uuidv4 } = require('uuid');
const uuid = uuidv4();
console.log(uuid);

3. 自定义实现

如果不想依赖第三方库,也可以自己实现一个简单的UUID生成函数。以下是一个基于原始答案的实现:

1
2
3
4
5
6
7
function uuidv4() {
return "10000000-1000-4000-8000-100000000000".replace(/[018]/g, c =>
(+c ^ crypto.getRandomValues(new Uint8Array(1))[0] & 15 >> +c / 4).toString(16)
);
}

console.log(uuidv4());

核心代码

自定义UUID生成函数

1
2
3
4
5
function uuidv4() {
return "10000000-1000-4000-8000-100000000000".replace(/[018]/g, c =>
(+c ^ crypto.getRandomValues(new Uint8Array(1))[0] & 15 >> +c / 4).toString(16)
);
}

使用uuid模块生成UUID

1
2
3
const { v4: uuidv4 } = require('uuid');
const uuid = uuidv4();
console.log(uuid);

最佳实践

  • 优先使用标准方法:如果你的项目运行在支持crypto.randomUUID()的环境中,优先使用该方法,因为它是标准且安全的。
  • 使用成熟的第三方库:对于需要兼容旧版平台或非安全上下文的项目,使用uuid模块可以确保生成的UUID符合RFC4122标准。
  • 避免使用Math.random():基于Math.random()的UUID生成方法不能提供良好的唯一性保证,因此不建议在生产环境中使用。

常见问题

1. crypto.randomUUID()在某些环境中不可用

crypto.randomUUID()仅适用于本地(localhost或127.0.0.1)或通过HTTPS提供服务的页面。如果在其他环境中使用,会导致该方法不可用。此时可以考虑使用uuid模块或自定义实现。

2. 基于Math.random()的UUID生成方法存在碰撞风险

Math.random()生成的随机数质量较低,不能保证生成的UUID的唯一性。因此,在对唯一性要求较高的场景中,应避免使用基于Math.random()的UUID生成方法。

3. 不同版本的UUID有什么区别

根据RFC 4122标准,UUID有不同的版本,常见的有版本1(基于时间)、版本4(基于随机数)和版本5(基于命名空间和名称)。版本4是最常用的版本,它基于随机数生成,具有较高的唯一性。


JavaScript中创建GUID/UUID的方法
https://119291.xyz/posts/2025-04-17.javascript-guid-uuid-generation-methods/
作者
ww
发布于
2025年4月17日
许可协议