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 要撑多久？在哪比对？谁来验证格式？”
