std::filesystem::file_size不能用于分片校验，因其仅返回文件总长，无法定位offset处的指定长度数据；MD5要求字节序列完全一致，需用seekg+read配合off_t和gcount()安全读取，并用OpenSSL EVP_MD_CTX流式计算摘要。
为什么 std::filesystem::file_size 不能直接用于分片校验
因为断点续传的“本地分片”往往不是完整文件，而是从某个 offset 开始、固定大小的二进制块（比如每块 4MB），而 std::filesystem::file_size 只能返回整个文件长度，无法定位到某一段。更关键的是：MD5 必须对**完全一致的字节序列**计算，哪怕 offset 或 length 差 1 字节，结果就完全不同。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 用
std::ifstream配合std::ios::binary | std::ios::ate打开文件，再用seekg(offset)跳转，read(buf, size)读取指定长度 - 务必检查
gcount()返回值——它才是实际读到的字节数；网络中断或磁盘损坏可能导致读不满，此时 MD5 不应继续计算 - 不要用
std::string存原始二进制数据（可能被截断），改用std::vector<:byte></:byte>或std::vector<char></char>
如何用 OpenSSL 的 EVP_MD_CTX 增量计算分片 MD5
一次性把几 GB 分片全读进内存不现实，必须流式计算。OpenSSL 的 EVP 接口支持增量更新，比手写 MD5 循环靠谱得多，也避免自己处理字节序、填充等细节出错。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 初始化用
EVP_MD_CTX_new()，算法选EVP_md5()；每次EVP_DigestUpdate(ctx, buf, len)输入一块数据 - 最后调
EVP_DigestFinal_ex(ctx, md_value, &md_len)获取 16 字节摘要，再用fmt::format("{:02x}", ...)或手动转十六进制字符串 - 别忘了
EVP_MD_CTX_free(ctx)，否则内存泄漏；C++17 起可用 RAII 封装，但原生 OpenSSL 没提供，得自己写 - Windows 下链接时加
-lcrypto -lssl，Linux 同理；macOS 可能需额外指定-I/opt/homebrew/include -L/opt/homebrew/lib
fseek / lseek 在大文件上容易失败？换 seekg + off_t
传统 C 的 fseek 对大于 2GB 的文件在某些平台（尤其是 Windows + MSVC）会因 long 类型溢出失败，错误码常是 EINVAL 或直接返回 -1。C++ 的 seekg 底层调用更健壮，且支持 off_t（通常为 64 位）。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 打开文件时用
std::ios::binary，避免文本模式换行符转换干扰二进制内容 - offset 和 length 全部声明为
off_t（或int64_t），不要用size_t——它在 32 位系统上只有 4 字节 - 调用
seekg(offset, std::ios::beg)后，立刻检查if (!ifs)，失败则说明 offset 超出文件范围或权限不足 - 如果分片跨越文件末尾（比如最后一块只剩 1MB），按实际剩余字节数读取，而非强行读满
本地分片 MD5 和服务端返回值比对失败的三个高频原因
不是算法写错了，往往是环境或协议细节没对齐。90% 的“校验失败”其实和 MD5 计算本身无关。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 确认服务端 MD5 是对**原始分片字节**计算的，而不是对 base64 编码后字符串、或加了前缀/后缀（比如
"part_" + data）再算的 - 检查分片起始 offset 是否对齐：服务端可能要求 offset 必须是 4MB 的整数倍，而你本地按“第 n 块”硬算，忽略了上一块实际只写了 3.8MB
- Windows 下注意文件是否被杀毒软件锁定，导致
read()返回 0；可临时关闭实时防护验证
最麻烦的其实是分片边界状态的持久化——断点信息存在哪、怎么保证写入原子性、并发下载时如何加锁。这些不解决，MD5 校验再准也没用。
