1. 什么是 UUID 及其用途

UUID（通用唯一标识符）是一种在软件开发中使用的标识标准，用于创建唯一键，无需集中管理。JavaScript (Node.js) 的 uuid 库提供了一种简单可靠的方法来生成版本 1、3、4、5 和 7（在最新版本中）的 UUID。它是 Node.js 生态系统中下载量最大、最受欢迎的库之一，每周下载量超过 5000 万次。

为什么需要它？在现代开发中，几乎每个应用程序都需要唯一标识符：用于数据库记录、用户身份识别、会话、订单、文件等等。使用 UUID 即使在分布式系统中也能避免冲突（标识符重复），在分布式系统中，多个服务器同时生成标识符。例如，如果您有一个微服务架构，每个服务独立创建记录，UUID 可以保证两个服务永远不会创建具有相同 ID 的记录。

uuid 库支持多个标准版本：v1（基于时间和 MAC 地址）、v4（随机生成）、v7（时间戳 + 随机数据——针对数据库优化的新标准）。版本 4 因其简单性和高度唯一性而最为常用。版本 7 被推荐用于新项目，因为它提供了自然的时间排序，从而提高了数据库索引的性能。

2. 安装

通过 npm（Node 包管理器）在 Node.js 项目中安装 uuid 库。在项目根文件夹中打开终端并执行以下命令：

npm install uuid

如果您使用 yarn：

yarn add uuid

安装后，该库即可在您的代码中导入使用。对于 TypeScript 项目，类型定义也可用（随包自动安装）。

3. 快速入门——最小工作示例

创建一个文件 example.js 并添加以下代码：

import { v4 as uuidv4 } from 'uuid';\n\n// 生成一个 UUID v4\nconst myUUID = uuidv4();\nconsole.log('生成的 UUID:', myUUID);\n// 示例输出：'9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d'

使用命令 node example.js 运行该文件。您将在控制台中看到生成的 UUID。这是一个最小示例，演示了该库的核心功能——生成一个标识符。

4. 主要方法/函数

uuid 库提供了多个函数用于生成不同版本的 UUID。下面详细介绍每一个。

4.1. v1() — UUID 版本 1（基于时间）

签名： v1(options?, buffer?, offset?)

描述： 生成版本 1 的 UUID，其中包含时间戳（自 1582 年 10 月 15 日以来的 100 纳秒间隔）和设备的 MAC 地址。这保证了时间和空间上的唯一性。然而，使用 MAC 地址可能会带来隐私问题。

import { v1 as uuidv1 } from 'uuid';\n\nconst uuid1 = uuidv1();\nconsole.log('UUID v1:', uuid1);\n// 示例：'c9b1deb4-3b7d-11ec-8d3d-0242ac130003'\n\n// 带选项：禁用 MAC 地址（使用随机节点）\nconst uuid1NoMac = uuidv1({ node: [0x01, 0x23, 0x45, 0x67, 0x89, 0xab] });\nconsole.log('UUID v1 使用自定义节点:', uuid1NoMac);