最稳妥的方式是直接使用OpenSSL的MD5()函数：只需#include 、链接-lcrypto，传入数据指针与长度（用size()而非strlen防\0截断），输出16字节digest，再转32位小写hex字符串即可。
直接用 OpenSSL 的 MD5() 函数最省事，不用自己实现、不踩大小端/填充/字节序坑，且结果可验证。
用 OpenSSL 的 MD5() 函数（C 风格接口）
这是 C++ 项目中最常用、最稳妥的方式。OpenSSL 提供了纯 C 接口，但完全兼容 C++，无需封装就能用。
-
MD5()是单次调用函数，适合已知完整数据（如字符串、内存块），不支持流式分段更新 - 头文件只需
#include <openssl></openssl>，链接时加-lcrypto - 注意：
MD5_DIGEST_LENGTH是宏，值为16，不是sizeof("md5")或strlen结果 - 输入数据指针不能是
nullptr，长度传0是合法的（输出全零，但符合 RFC） - 错误现象示例：如果忘记链接
-lcrypto，会报undefined reference to `MD5'
示例：
unsigned char digest[MD5_DIGEST_LENGTH]; const char* data = "hello world"; MD5(reinterpret_cast<const unsigned char*>(data), strlen(data), digest); // digest 现在含 16 字节二进制结果，转 hex 可用 sprintf 或 std::format
自己写 MD5 类（避免 OpenSSL 依赖）
仅当明确不能引入 OpenSSL（如嵌入式裸机、许可冲突、或教学目的）时才考虑。已有多个开源实现可复用，但必须注意几个硬伤点：
立即学习“C++免费学习笔记（深入）”；
- 所有自实现都必须严格按 RFC 1321 做：补位字节是
0x80+ 若干0x00+ 最后 8 字节为原始消息长度（bit 数，不是 byte 数） - 大小端处理必须一致：MD5 内部是小端运算，但输入字节流按网络序（大端）解释 —— 多数 C++ 实现用
GET_UINT32宏做翻转，漏掉就全错 - 缓冲区未对齐或
buffer[64]溢出会导致静默错误（比如传入 65 字节却没触发分块逻辑） - 类接口如
update()+finalize()看似灵活，但若多次调用update()后忘了finalize()，hexdigest()会返回脏数据
HMAC-MD5 怎么办？标准库不支持
C++ 标准库（包括 C++23 的 std::md5_hasher）只提供无密钥的 MD5，**不支持 HMAC-MD5**。别试图用 std::hash 或拼接密钥字符串——那不是 HMAC，也不抗长度扩展攻击。
- 真正合规的 HMAC-MD5 必须用
HMAC(EVP_md5(), key, key_len, data, data_len, ...)，且key_len必须显式传（不能用strlen(key)，二进制密钥含\0就截断） - OpenSSL 的
HMAC()要求链接-lcrypto，且EVP_md5()不能换成EVP_sha256()—— 底层哈希算法和 HMAC 构造强绑定 - 常见翻车：手写 HMAC 时把内层 XOR 常量
0x36和外层0x5c顺序弄反，或 key 长度 > 64 字节时没先哈希再填充，结果和 OpenSSL 不兼容
真正难的不是“怎么算出一串 32 位 hex”，而是确保每一步填充、字节序、长度字段都和标准对齐；OpenSSL 已经过几十年实战检验，优先用它，除非你清楚自己在绕开什么。
