C++如何生成UUID？（跨平台唯一标识符创建）

boost 是目前 c++ 跨平台生成 uuid 最成熟的选择，boost::uuids::random_generator 底层调用系统熵源生成符合 rfc 4122 的 v4 uuid，应长期持有 generator 对象而非每次构造。

用 boost::uuids::random_generator 最省心

Boost 是目前 C++ 跨平台生成 UUID 最成熟的选择，boost::uuids::random_generator 底层调用系统熵源（如 /dev/urandom 或 CryptGenRandom），生成符合 RFC 4122 的 v4 UUID。它不依赖外部服务、不联网、不写磁盘，适合嵌入式和服务器场景。

常见错误是直接 new 一个 generator 反复调用 —— 这会导致重复 UUID（内部状态未正确维护）：

• ✅ 正确：每次需要 UUID 时调用 gen()，gen 对象应长期持有或静态初始化
• ❌ 错误：auto uuid = boost::uuids::random_generator()(); —— 每次构造新 generator，种子可能相同
• 注意 windows 下需链接 bcrypt.lib（Boost 1.70+ 自动处理，旧版需手动加）

boost::uuids::random_generator gen; boost::uuids::uuid u = gen(); // 安全 std::string s = to_string(u); // "f81d4fae-7dec-11d0-a765-00a0c91e6bf6"

不用 Boost？自己封装 std::random_device 风险高

C++11 起有 std::random_device，但直接用它填 UUID 字节数组容易出错：它的熵质量在不同平台差异大，MSVC 的 std::random_device 在某些版本下其实是伪随机（返回固定序列），Clang/libc++ 在 macos 上默认走 arc4random 较可靠，linux 通常映射到 /dev/urandom。

• ⚠️ 不要假设 rd() 返回值足够随机 —— 必须检查 rd.entropy()，若为 0 则不可用于 UUID
• UUID v4 要求 6 位版本号（0b0100）和 2 位变体号（0b10xxxx），必须手动置位，漏改会生成非法 UUID
• 性能上无明显优势，反而增加出错概率；除非明确禁止第三方依赖，否则不建议手撸

编译时生成 UUID？别用 __DATE__ + __TIME__

有人试图用宏拼接时间戳当唯一 ID，这完全不可靠：

立即学习“C++免费学习笔记（深入）”；

• 多线程并发编译时，__DATE__/__TIME__ 相同，生成重复 ID
• 增量编译下不重新展开宏，同一份代码多次构建得到相同“UUID”
• 不符合 UUID 格式（无分隔符、无版本/变体位、长度不对），下游解析器会直接拒绝
• 真正需要编译期唯一标识，应改用 __COUNTER__ + 哈希（如 std::hash<int>{}(__COUNTER__)</int>），但依然不是 UUID

Windows 上调用 UuidCreate 要小心 COM 初始化

原生 Win32 API UuidCreate 确实可用，但它内部依赖 rpc 运行时，未初始化 COM 时调用会返回 RPC_S_UUID_LOCAL_ONLY 错误（不是崩溃，而是静默降级为本地唯一、非全局唯一）。

• 必须先调用 CoInitializeEx(nullptr, COINIT_MULTITHREADED) 或 COINIT_APARTMENTTHREADED
• 生成后需用 UuidToString 转字符串，且返回内存需 RpcStringFree 释放，漏掉就内存泄漏
• 跨平台项目里混用 Win32 API 会破坏可移植性，除非你只跑 Windows 且已绑定 RPC 依赖

UUID 的本质是“统计意义上唯一”，不是绝对数学唯一。真正关键的是生成逻辑是否隔离、熵源是否可信、格式是否合规——而不是用哪个函数名。很多人卡在“怎么生成”，其实更该先问：“这个 UUID 要撑多久？在哪比对？谁来验证格式？”