用 OpenSSL 实现文件 MD5/SHA256 计算（推荐）
直接调用系统级加密库是最可靠的方式，OpenSSL 提供了稳定、经过审计的哈希实现。Windows/macOS/Linux 均可编译使用，关键是避免自己手写分块读取逻辑出错。
常见错误是把整个文件 fread 到内存再哈希——大文件（如 >1GB）会触发 OOM 或显著拖慢速度；正确做法是分块读取、增量更新哈希上下文。
- 链接时需加
-lssl -lcrypto（Linux/macOS），Windows 需配置 OpenSSL 的.lib路径 - MD5 用
EVP_MD_CTX_new+EVP_md5，SHA256 用EVP_sha256，别混用MD5_Init这类旧接口（已弃用且线程不安全） - 每次
EVP_DigestUpdate前检查返回值，0表示失败（如输入为nullptr） - 哈希结果是二进制字节，转十六进制字符串需手动循环转换，别用
printf("%x")直接输出——会丢前导零且大小端混乱
跨平台 C++ 封装：一个轻量 file_hash 函数
下面是一个只依赖
std::string file_hash(const std::string& path, const EVP_MD* md) {
std::ifstream file(path, std::ios::binary);
if (!file.is_open()) return "";
EVP_MD_CTX* ctx = EVP_MD_CTX_new();
if (!ctx || EVP_DigestInit_ex(ctx, md, nullptr) != 1) {
EVP_MD_CTX_free(ctx);
return "";
}
std::vector buf(8192);
while (file.read(reinterpret_cast(buf.data()), buf.size())) {
if (EVP_DigestUpdate(ctx, buf.data(), file.gcount()) != 1) break;
}
// 处理剩余不足一整块的数据
if (file.gcount() > 0) {
EVP_DigestUpdate(ctx, buf.data(), file.gcount());
}
unsigned int len;
std::vector digest(EVP_MD_size(md));
EVP_DigestFinal_ex(ctx, digest.data(), &len);
EVP_MD_CTX_free(ctx);
std::stringstream ss;
for (unsigned int i = 0; i < len; ++i) {
ss << std::hex << std::setw(2) << std::setfill('0') << (int)digest[i];
}
return ss.str(); }
// 使用：file_hash("input.bin", EVP_sha256());
不用 OpenSSL？用 std::filesystem + 算法库（C++23 起有限支持）
C++23 标准库仍未内置密码学哈希，所谓“标准方案”实际不存在。网上有些代码用 std::hash<:string> 是完全错误的——它不是密码学哈希，不可用于校验，碰撞率极高且无固定输出长度。
立即学习“C++免费学习笔记（深入）”；
若硬要避开 OpenSSL，可考虑：
- 嵌入 mini-crypto 库（如
tinysha2或md5-hash单头文件实现），但需人工验证其常量时间比较、抗侧信道能力 - 调用系统命令（
shasum -a 256 file/certutil -hashfile file SHA256），但依赖环境、无法捕获错误码、路径含空格易崩 - Windows 上可用
BCryptHashData（bcrypt.h），但 API 冗长，初始化和清理步骤多，容易漏掉BCryptDestroyHash
校验时最容易忽略的三个细节
哈希值对文件内容零容忍，微小差异就会导致完全不同输出，但很多问题藏在“看不见”的地方：
- 文本文件换行符：Windows 的
\r\n和 Linux 的\n会被视为不同字节，校验前确认是否需 normalize（比如统一转 LF） - 文件末尾 BOM：UTF-8 文件开头可能有
EF BB BF，肉眼不可见但影响哈希——用十六进制编辑器确认原始字节 - 符号链接与硬链接：
std::filesystem::is_symlink返回 true 时，std::ifstream默认跟随链接，若需校验链接本身（而非目标），得用read_symlink并哈希路径字符串
真正难的不是算哈希，而是确保你哈希的是用户预期的那个“文件内容”。路径、编码、元数据、挂载选项……任何一层偏差都会让校验失效。
