应使用std::filesystem::recursive_directory_iterator并过滤正规文件，分块二进制读取计算MD5，每个文件独立初始化OpenSSL哈希上下文，先排序路径再顺序哈希以保证结果可重现。
用 std::filesystem 遍历目录但漏掉子目录
默认 std::filesystem::directory_iterator 只遍历一级，不会递归进子文件夹。想算整个文件夹的 MD5，必须显式启用递归或手动处理嵌套。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 用
std::filesystem::recursive_directory_iterator替代普通迭代器，它天然支持深度优先遍历 - 加一层
if (entry.is_regular_file())过滤，跳过目录、符号链接、socket 等非文件项 - 注意 Windows 下长路径（>260 字符）可能触发
std::filesystem::filesystem_error，需捕获并跳过
读大文件时内存爆掉或 MD5 错误
直接把整个文件 std::ifstream::rdbuf() 读进内存再算 MD5，遇到几百 MB 的日志或视频就崩。而且二进制读取不设 std::ios::binary 标志，Windows 下换行符会被悄悄转换，MD5 必然错。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 用分块读取：每次
read()8192 字节，喂给 MD5 更新函数（如 OpenSSL 的EVP_DigestUpdate()或自研增量哈希） - 打开文件务必加
std::ios::binary模式，避免文本模式干扰 - 别用
std::string当缓冲区存二进制数据；用std::vector<char></char>或裸char[]更安全
OpenSSL 的 EVP_MD_CTX 多次复用出错
常见错误是把一个 EVP_MD_CTX* 实例反复用于多个文件但没重置，导致后一个文件的哈希值混着前一个的残留状态，结果全错。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 每个文件单独调用
EVP_MD_CTX_new()→EVP_DigestInit_ex()→EVP_DigestUpdate()→EVP_DigestFinal_ex()→EVP_MD_CTX_free() - 或者复用 ctx：每次新文件前必须调用
EVP_DigestInit_ex(ctx, EVP_md5(), nullptr)清空内部状态 - 别忽略
EVP_DigestInit_ex()的返回值，失败时（比如 OpenSSL 初始化未完成）会返回 0
汇总校验值时顺序不可靠
文件系统遍历顺序不固定：recursive_directory_iterator 在不同平台、甚至同平台不同时间，返回的文件顺序都可能变。如果只是把所有 MD5 拼起来再算一次总哈希，结果不可重现。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 先收集全部文件路径到
std::vector<:filesystem::path></:filesystem::path>，再用std::sort()排序（按字典序） - 再按排序后顺序逐个计算 MD5，并把每个结果追加进一个缓冲区（如
std::vector<uint8_t></uint8_t>），最后对这个缓冲区算最终 MD5 - 若要兼容性更强，可把每个“路径+MD5”拼成一行（如
"./a.txt d41d8cd98f00b204e9800998ecf8427e"），再整体哈希 —— 这样还能顺便防止单个文件名含空格导致解析歧义
最麻烦的其实是路径编码和权限异常：Linux 下遇到权限不足的文件会抛异常，macOS 的 APFS 可能返回重复硬链接，这些都会让汇总中途退出。得提前 decide 是跳过、记录警告，还是强制中断 —— 这个逻辑没法交给库自动处理。
