标准库无std::md5，推荐使用单头md5.h；因其零依赖、跨平台，适用于非安全场景如构建缓存键；需用string_view或uint8_t*传参，输出16字节需手动转hex。

标准库没有 std::md5，别白费时间找；真要简单可用、非安全场景下校验文件或字符串，直接用单头 md5.h 最省事。

为什么不用自己手写 MD5 实现

网上一堆“几行搞定 MD5”的 C++ 代码，看着短，实际埋了至少三类坑：
— 初始向量写错（比如 0x67452301 写成 0x67452310），结果全错；
— 补位逻辑漏掉长度追加的 64 位大端存储，导致不同平台输出不一致；
— 字符串传入用 c_str() 而不是 data() + size()，遇到 '\0' 就截断。
这些错误不会报编译错，但哈希值对不上，调试成本远高于直接引入一个验证过的实现。

用单头 md5.h（如 mattiasgustavsson/libs 版本）

这个方案适合：本地工具脚本、构建缓存键、配置文件一致性检查等明确不涉密的场景。
优点是零依赖、头文件一拖就跑，Windows/Linux/macOS 全通。
使用时注意三点：

C++ Code Review Master

组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。

下载

• 必须用 std::string_view 或 const uint8_t* + size_t 传原始字节，别传 const char*；
• 输出是 16 字节 uint8_t[16]，转 32 位十六进制字符串得自己写循环，例如：

  for (int i = 0; i 

• 它不做输入长度溢出检查，若传入超 2^64−1 字节数据（极罕见），结果未定义。

用 OpenSSL 的 MD5_Init/MD5_Update/MD5_Final

这是生产环境唯一推荐的路径，尤其当你的程序已链接 libcrypto。
关键点不在函数调用本身，而在上下文生命周期管理：

• MD5_CTX 必须栈上或手动 malloc 分配，不能全局静态（多线程不安全）；
• 每次哈希前必须调 MD5_Init(&ctx)，哪怕刚用过；
• MD5_Final 会把 ctx 清零，不可重复调用——想再算一次？重 Init；
• 输入缓冲区若来自 std::string，务必用 s.data() 和 s.size()，c_str() 有隐式截断风险。

输出格式和常见误判点

MD5 原始输出永远是 16 字节二进制，32 位十六进制只是人类可读表示。容易踩的坑：

• 大小写混用：RFC 1321 规定小写，但有些旧系统比对时忽略大小写，有些则严格区分；
• 空格/换行干扰：从文件读取校验值时，fgets 可能带 \n，std::getline 默认不删，比对前记得 erase 尾部空白；
• 编码陷阱：对 UTF-8 字符串算 MD5 没问题，但若误用 GBK 读取再传入，哈希值必然错——MD5 不懂字符集，只认字节流。

真正难的从来不是“怎么写出 MD5”，而是确保你喂给它的字节，和别人喂给它的字节，完全一致。

C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！