std::ifstream 是读取文件计算 md5 最稳妥的方式，需以 binary 模式打开，分块读取避免 oom，配合 openssl 增量 api 计算完整字节流摘要，并注意 windows 路径编码与长度限制。
用 std::ifstream 读取文件并计算 MD5，别直接 mmap
MD5 计算必须完整读取文件内容，std::ifstream 是最稳妥的选择。虽然 mmap 看起来快，但在 Windows 上不跨平台，且对空文件、权限异常、稀疏文件等边界情况处理复杂，容易 crash 或漏读。C++ 标准库没有内置 MD5，得靠第三方实现（如 OpenSSL 或轻量级头文件库），但无论选哪个，输入都应该是完整的字节流。
常见错误是只读前 N 字节（比如误以为“文件头变了就代表改了”），这完全不可靠——修改末尾几字节，MD5 就完全不同；而只读开头，根本检测不到。
- 务必以
std::ios::binary模式打开，否则 Windows 下换行符会被悄悄转换，MD5 失效 - 用
file.seekg(0, std::ios::end)+file.tellg()获取准确大小，再seekg(0)回头读，避免eof()判定陷阱 - 分块读取（如 8KB 缓冲区），别一次性
read()整个大文件到内存——几十 GB 的日志文件会 OOM
OpenSSL 的 MD5_Update() 必须配合 MD5_Init() 和 MD5_Final()
直接调 MD5() 函数（单次全量接口）看似简单，但它要求把整个文件内容作为 const unsigned char* 传入，意味着你得先 malloc 或 std::vector 分配一块和文件等大的内存——这是冗余拷贝，且破坏流式处理逻辑。正确做法是用增量式 API：
MD5_CTX ctx;
MD5_Init(&ctx);
while (size_t n = file.readsome(buffer, sizeof(buffer))) {
MD5_Update(&ctx, buffer, n);
}
MD5_Final(digest, &ctx);
注意：readsome() 不保证读满缓冲区，更安全的做法是用 file.read(buffer, sizeof(buffer)) 后检查 file.gcount()；MD5_Final() 会自动 padding 并输出 16 字节二进制摘要，别忘了转成 32 字符小写 hex 字符串用于存储或比对。
保存和比对 MD5 值时，别忽略文件元信息的干扰
只比 MD5 不能 100% 确定“文件被修改”，因为：
- 同一内容、不同编码保存的文本文件（如 UTF-8 vs UTF-8-BOM），MD5 不同
- 文件系统可能修改
mtime而内容未变（如touch），但你的程序若只依赖时间戳就误判，而 MD5 才是真实依据 - 符号链接目标变化、硬链接计数变化，不影响 MD5——这是优点，不是 bug
所以，如果你的场景是“监控配置文件是否真正变更”，就该只存 MD5；如果还要知道“谁改的、何时改的”，就得额外记录 stat() 结果。别把 MD5 当万能时间戳用。
Windows 下路径含中文或长路径时，fopen 失败但 std::ifstream 可能静默截断
VC++ 的 std::ifstream 默认不支持 UTF-8 路径（即使源码保存为 UTF-8），传入含中文的 std::string 路径大概率打开失败，且 is_open() 返回 false，但不会抛异常。更隐蔽的问题是：当路径超过 MAX_PATH（260 字符），普通路径会失败，必须加 \\?\ 前缀。
解决方法很实在：
- 用
std::filesystem::u8path()（C++17）把 UTF-8 字符串转为std::filesystem::path，再调std::ifstream(path.c_str(), ...)，它在 MSVC 2019+ 会自动处理长路径和编码 - 若无法用 C++17，就改用 Windows API 的
CreateFileW()+ReadFile()，配合MultiByteToWideChar(CP_UTF8, ...)转路径 - 无论如何，打开后立刻检查
if (!file) { /* 处理错误 */ }，别假设路径一定合法
MD5 本身没平台差异，但路径处理一错，连文件都打不开，后面全白算。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
