1. 什么是 uuid 以及为什么需要它？

用于 Rust 的 uuid 库是最流行且最稳定的 crate 之一，用于根据 RFC 4122 标准生成、解析和操作通用唯一标识符 (UUID)。UUID 是一个 128 位的数字，在空间和时间上保证唯一，使其非常适合用作数据库中的主键、会话标识符、事件跟踪器以及任何需要无需集中管理即可保证唯一性的场景。

为什么需要这个库？在现代 Rust 开发中，经常需要生成不依赖于对象创建顺序、不泄露记录数量信息（与自增 ID 不同）且可以在不同系统间安全传递的唯一标识符。uuid crate 提供了完整的工具集，用于处理版本 1、3、4、5 和 7 的 UUID（版本 7 是基于时间的版本，在最近的更新中添加）。它支持通过 serde 进行序列化、处理不同的表示格式（规范格式、无连字符格式、URN）以及通过相应特性与流行数据库集成。

该库由社区积极维护，拥有出色的文档，并被数千个项目使用。它完全用纯 Rust 编写，没有外部依赖（可选特性除外），保证了内存安全和高性能。无论您是在编写 Web 服务器、分布式系统、命令行工具还是任何其他需要唯一标识符的 Rust 应用程序，uuid 都将是您不可或缺的助手。

2. 安装

要将 uuid 库添加到您的 Rust 项目中，请在项目根目录中执行以下任一命令：

cargo add uuid

或者手动将依赖项添加到 Cargo.toml 文件中：

[dependencies]\nuuid = { version = "1.10", features = ["v4", "v7", "serde"] }

请注意 features 部分。默认情况下，该库仅包含基本功能。要使用特定版本的 UUID，您需要显式指定相应的特性：

\n
• v1 — UUID 版本 1（基于时间和 MAC 地址）
\n
• v3 — UUID 版本 3（基于名称和命名空间的 MD5 哈希）
\n
• v4 — UUID 版本 4（随机）
\n
• v5 — UUID 版本 5（基于名称和命名空间的 SHA-1 哈希）
\n
• v7 — UUID 版本 7（基于时间，毫秒精度，RFC 9562）
\n
• serde — 通过 serde crate 支持序列化/反序列化
\n
• fast-rng — 使用快速随机数生成器（推荐用于 v4）
\n

如果您需要所有功能，可以指定：

[dependencies]\nuuid = { version = "1.10", features = ["v1", "v3", "v4", "v5", "v7", "serde"] }

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

使用命令 cargo new uuid_example 创建一个新项目，按上述方法将依赖项添加到 Cargo.toml，然后将 src/main.rs 文件的内容替换为以下代码：

use uuid::Uuid;\n\nfn main() {\n    // 生成一个随机的版本 4 UUID\n    let my_uuid = Uuid::new_v4();\n    println!("生成的 UUID v4: {}", my_uuid);\n    \n    // 从字符串解析 UUID\n    let parsed = Uuid::parse_str("550e8400-e29b-41d4-a716-446655440000")\n        .expect("无法解析 UUID");\n    println!("解