c++标准库不提供md5函数，需用openssl（推荐）或单头md5.h（仅非安全场景）；openssl调用需md5_init→update→final三步，输入用.data()避免截断，输出16字节需手动转十六进制。
MD5在C++里没有标准库实现
别找 std::md5，C++标准库至今（C++20/C++23）**不提供任何哈希摘要函数**，MD5更不在其中。想用MD5，必须引入第三方实现或自己写——但自己写密码学原语极其危险，不推荐。
实际项目中，最稳妥的选择是：OpenSSL（成熟、广泛验证、支持多平台），其次是轻量级的 md5.h 单头文件（如 mattiasgustavsson/libs 中的版本），但要注意它不校验输入长度溢出，也不防侧信道，仅适合非安全场景（如文件名生成、缓存键）。
- 用
OpenSSL：需链接-lcrypto，Windows 下注意libeay32.lib或新版本的libcrypto.lib - 用单头
md5.h：直接#include，无依赖，但别用于密码、签名、权限校验等安全用途 - 别用网上搜到的“几行手写MD5”——轮函数顺序错一位、初始向量写反、大小端处理漏掉，结果就全错，且很难调试
OpenSSL实现MD5的三步调用（C风格API）
OpenSSL 的 MD5 接口是纯C函数，C++里调用干净利落，但容易卡在初始化和内存管理上。
核心流程就三步：MD5_Init → MD5_Update → MD5_Final，中间不能漏掉任何一步，且 MD5_Final 会清空上下文，不可重复调用。
立即学习“C++免费学习笔记（深入）”；
-
MD5_CTX必须栈分配或显式new，不能传野指针；用完不需free（它不含堆内存） - 输入数据是
const unsigned char*，传std::string要用.data()+.length()，别用.c_str()——遇到\0会截断 - 输出是 16 字节二进制，转十六进制字符串得自己写循环，别依赖
printf("%02x")直接打——字节序没问题，但要确保循环 16 次，不是.size()
unsigned char digest[MD5_DIGEST_LENGTH];
MD5_CTX ctx;
MD5_Init(&ctx);
MD5_Update(&ctx, reinterpret_cast<const unsigned char*>(data.data()), data.length());
MD5_Final(digest, &ctx);
std::string result;
for(int i = 0; i < MD5_DIGEST_LENGTH; ++i) {
char buf[3];
sprintf(buf, "%02x", digest[i]);
result += buf;
}
std::string 输入含中文或宽字符时的坑
MD5只认字节流，不管编码。如果你传的是 UTF-8 编码的 std::string，没问题；但若误用 std::wstring 或把 GBK 字符串当 UTF-8 传，哈希值就完全不可重现。
- 确认源字符串编码：Linux/macOS 终端、UTF-8 文件读入的
std::string是安全的；Windows 上用MultiByteToWideChar转过再存成std::string？那大概率已乱码 - 别对
std::wstring直接取.data()——那是wchar_t*，每个元素 2 或 4 字节，MD5_Update会当成原始字节喂给算法，结果毫无意义 - 需要处理宽字符串时，先明确目标编码（通常是 UTF-8），用
std::wstring_convert<:codecvt_utf8>></:codecvt_utf8>（C++17 起已弃用，但仍是目前最稳方案）或跨平台库（如iconv/utf8cpp）转码
MD5不适合做校验？那什么时候真该换算法
MD5 碰撞已被实证攻破，2008 年就有伪造 SSL 证书的案例。但它仍大量用于非密码学场景——比如构建构建缓存键、比对大文件是否相同、日志去重。
是否该换，取决于你的「校验」目标：
- 只是防止偶然损坏（如下载中途断电）→
MD5够用，快，兼容老系统 - 要防恶意篡改（如配置文件签名、固件更新包）→ 必须换
SHA256或更强，用EVP_DigestInit_ex替代MD5_*系列 - 要和其它语言/系统互通哈希值 → 确保双方都用同样编码、同样字节序、同样填充规则；MD5 本身没歧义，但字符串编码不一致就是最大陷阱
真正难的从来不是调哪个函数，而是搞清你到底在防什么、谁可能动这个数据、以及上下游系统怎么解释这一串字节。
