JavaScript 生成 UUID 的常用方法及注意事项

这种方法既能保持加密安全性，又能支持旧环境。

uuid npm 包，实现最大灵活性

uuid npm 包仍然是生成 JavaScript UUID 最通用的解决方案，尤其是在需要特定 UUID 版本或最大兼容性时。

安装

npm install uuid

基本用法（UUID v4）

import { v4 as uuidv4 } from 'uuid';

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

其他 UUID 版本

import { v1, v3, v5 } from 'uuid';

// v1: Timestamp-based (sortable)
const uuid1 = v1();

// v3/v5: Name-based (deterministic)
const uuid5 = v5('hello.example.com', v5.DNS);

uuid 软件包支持所有 UUID 版本（v1-v5），因此在您需要以下功能时非常理想：

• 基于时间戳的可排序标识符 UUID（v1）
• 从命名空间/名称对中确定性 UUID（v3、v5）
• 向后兼容旧版 Node.js
• React Native 或其他非标准环境

何时避免使用 Math.random()

虽然您可能会发现使用 Math.random() 的 UUID 实现，但这些应该仅用于测试或非安全环境：

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

Math.random() 缺乏加密安全性，不应用于生产环境 UUID。

最佳实践和验证

UUID 验证

务必验证来自外部来源的 UUID：

function isValidUUID(uuid) {
  const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
  return uuidRegex.test(uuid);
}

console.log(isValidUUID('550e8400-e29b-41d4-a716-446655440000'));
// true

选择合适的方法

• 现代 Web 应用程序或 Node.js 14.17+：使用 crypto.randomUUID()
• 需要对旧版浏览器提供支持：实现方式 crypto.getRandomValues()
• 特定 UUID 版本（v1、v3、v5）：使用 uuid npm 包
• 最大程度的兼容性：使用 uuid npm 包
• 仅供快速测试/原型开发：Math.random() 实现

结论

JavaScript 中的 UUID 生成不必复杂。对于大多数现代应用程序来说，crypto.randomUUID() 它提供了一个简单且安全的解决方案。当您需要更广泛的兼容性或特定版本的 UUID 时，uuid npm 包可以满足您的需求。只需记住，在生产环境中避免使用 Math.random()，并验证来自外部来源的任何 UUID。

选择适合您的环境和需求的方法——未来的您（和您的团队）会感谢您在整个代码库中使用清晰、可靠的唯一标识符。

常见问题解答

UUID v4 和 v5 有什么区别？

UUID v4 使用随机数或伪随机数，因此每个 ID 都不可预测。UUID v5 使用 SHA-1 哈希算法，根据命名空间和名称生成确定性 ID，因此相同的输入始终生成相同的 UUID。

可以在 React Native 中使用 crypto.randomUUID() 吗？

不，React Native 本身并不支持 crypto.randomUUID()。请改用 uuid npm 包，它提供了一个兼容的实现，可以在各种 React Native 环境中使用。

如何生成简短的唯一 ID 而不是完整的 UUID？

对于较短的 ID，可以考虑使用 nanoid 或 shortid 包。它们生成的 URL 安全唯一字符串比 UUID 更紧凑，同时又能满足大多数应用的唯一性要求。

在 URL 或公共 API 中暴露 UUID 是否安全？

是的，UUID v4 值经过加密随机处理，可以安全公开。但是，请避免在公共场合使用 UUID v1，因为它包含时间戳和 MAC 地址信息，可能会泄露系统详细信息。