应使用std::ifstream以std::ios::binary模式分块读取文件（如8KB），配合OpenSSL的MD5_Init/Update/Final三步流式计算MD5，避免文本模式换行符转换、mmap跨平台问题及内存溢出。
用 std::ifstream 读取文件并计算 MD5，别直接 mmap 或 fopen
MD5 计算依赖完整字节流，必须按二进制模式读取，否则换行符（
→
）会被悄悄转换，导致哈希值错乱。C++ 标准库不带 MD5，得靠 OpenSSL、Boost 或手写实现；OpenSSL 最常用也最稳。
常见错误是用 std::ifstream 默认文本模式打开，或用 std::getline 逐行读——这会丢掉末尾换行、跳过空行、截断 ，哈希必然失效。
- 务必用
std::ios::binary标志打开：std::ifstream file(path, std::ios::binary) - 不要用
file >>或getline()，改用file.read(buf, size)或整个读入std::vector<char> - 若文件超大（>100MB），分块读取（如 8KB/次），避免内存爆掉
OpenSSL 的 MD5_Update() 要配合 MD5_Init() 和 MD5_Final() 三件套
OpenSSL 的 MD5 接口是 C 风格，状态必须显式管理：初始化 → 多次更新 → 终止获取结果。漏掉任一环节，输出就是随机垃圾。
典型坑是只调一次 MD5_Update() 就直接 MD5_Final()，但没 MD5_Init() 初始化内部结构体，结果未定义；或者多次 MD5_Init() 后没 MD5_Final()，内存里留着脏状态。
立即学习“C++免费学习笔记（深入）”；
- 每次计算新文件前，必须调
MD5_Init(&ctx) -
MD5_Update(&ctx, data, len)可调多次（适合分块读） - 最后必须
MD5_Final(digest, &ctx)，digest是unsigned char[16] - 记得链接
-lssl -lcrypto，macOS 还可能要-I/usr/local/opt/openssl/include
比对时别直接比较 raw digest，转成小写十六进制字符串再比
原始 MD5 是 16 字节二进制数据，不可读也不方便存配置或日志。实际保存和比对都该用 32 字符小写 hex 字符串（如 "d41d8cd98f00b204e9800998ecf8427e"）。大小写混用或带空格会导致字符串比较失败。
- 用
sprintf(buf, "%02x", digest[i])或 C++17 的std::format("{:02x}", digest[i])逐字节转 - 确保全部 32 位字符参与比较，
std::string::compare()或==即可 - 如果上次 hash 存在 JSON 或 ini 文件里，确认没被编辑器自动加 BOM 或换行 —— 读出来多一个
或
注意跨平台文件系统行为：NTFS 硬链接、APFS 克隆、符号链接都影响“是否修改”判断
MD5 比对的是内容，不是文件元数据。但用户直觉里的“文件被修改”有时包含时间戳变更、硬链接计数变化、甚至 macOS 上的 com.apple.FinderInfo 扩展属性。仅靠 MD5 无法捕获这些。
更隐蔽的问题：APFS 的文件克隆（clonefile）、NTFS 的重解析点、Linux 的 reflink，会让两个路径指向同一份物理数据 —— 改一个，另一个看似没动，其实内容已变。此时单看当前路径的 MD5 是“没变”，但语义上它已被影响。
- 如果业务要求严格追踪所有访问路径，需额外记录
st_ino+st_dev，并定期检查硬链接数或克隆状态 - 符号链接默认会被
open()自动解引用，但若你用stat()获取路径本身属性，就和 MD5 完全无关了 - Windows 上注意
\?前缀路径是否被正确传递给fopen，否则长路径或含:的文件名会打不开
