什么是 UUID？为什么要使用它？
UUID（通用唯一标识符）是一个 128 位标识符，格式为 36 个字符：550e8400-e29b-41d4-a716-446655440000。这些标识符也称为 GUID，几乎可以保证其唯一性，而无需中央机构或数据库协调。
对于前端和 Node.js 开发人员来说，UUID 解决了关键问题：
- 数据库记录：生成无自增冲突的主键
- 会话令牌：创建不可预测的、唯一的会话标识符
- 文件命名：防止上传内容出现命名冲突
- 请求跟踪：跟踪跨微服务的操作
要点总结
- 适用
crypto.randomUUID()于现代环境（Node.js 14.17+ 和最新版本的浏览器） - 实现
crypto.getRandomValues()对旧版浏览器的支持，并具备加密安全性 - 当您需要特定 UUID 版本或最大兼容性时，请选择
uuidnpm 包。 Math.random()由于缺乏加密安全性，切勿在生产环境中使用 UUID。
现代方法：crypto.randomUUID()
crypto.randomUUID() 方法是目前现代环境中生成唯一 ID 值的标准方法。它已内置于浏览器和 Node.js（14.17+）中，无需任何依赖项，并生成加密安全的 UUID v4 值。
浏览器实现
const uuid = crypto.randomUUID();
console.log(uuid);
// "3b99e3e0-7598-4bf8-b9c1-e915af91713c"
Node.js 实现
import { randomUUID } from 'crypto';
const uuid = randomUUID();
console.log(uuid);
// "b7e44f0a-811f-4c1c-b7f0-48d51f5dbc1f"
浏览器支持：Chrome 92+、Firefox 95+、Safari 15.4+、Edge 92+； Node.js 支持：版本 14.17.0+
crypto.randomUUID() 当您需要在现代应用程序中使用安全、随机的 UUID 而无需外部依赖项时，请使用此方法。
备用方法：crypto.getRandomValues()
对于不支持的环境 crypto.randomUUID()，您可以使用其他方法实现 UUID v4 生成 crypto.getRandomValues()。此方法适用于 Chrome 11 及更高版本的浏览器以及安装了 crypto 模块的 Node.js 版本。
function generateUUID() {
return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function(c) {
const r = crypto.getRandomValues(new Uint8Array(1))[0];
const v = c === 'x' ? (r & 0x0f) : ((r & 0x03) | 0x08);
return v.toString(16);
});
}
const uuid = generateUUID();
console.log(uuid);
// "42254574-affd-47cc-9915-0ecae592351b"
这种方法既能保持加密安全性，又能支持旧环境。
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）：使用
uuidnpm 包 - 最大程度的兼容性：使用
uuidnpm 包 - 仅供快速测试/原型开发：
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 地址信息，可能会泄露系统详细信息。
