最稳方式是调用evp_digestinit_ex、evp_digestupdate、evp_digestfinal_ex三步闭环，需检查每步返回值，用evp_sha256()而非字符串，二进制模式读文件，8kb缓冲，32字节结果用"%02x"转小写十六进制。
用OpenSSL的EVP接口计算SHA256最稳
直接调 EVP_DigestInit_ex + EVP_DigestUpdate + EVP_DigestFinal_ex 是C++里最可靠的方式，比自己读文件拼接、或用第三方轻量库更可控。OpenSSL 1.1.1+ 和 3.x 都支持，Windows/macOS/Linux 全平台可用。
常见错误是没检查返回值——EVP_DigestInit_ex 可能失败（比如传错digest类型），EVP_DigestUpdate 在读取超大文件时也可能因内存映射失败而静默出错，必须逐次判断。
- 始终用
EVP_sha256()，别写字符串"sha256"—— OpenSSL不认字符串名 - 缓冲区大小建议设为
8192（8KB），太小频繁系统调用，太大无必要 - 读文件必须用二进制模式：
std::ifstream file(path, std::ios::binary)，否则Windows下换行符被转义，哈希值错 - 最后输出的32字节结果要转十六进制：每个字节用
std::hex
读大文件时别一次性load到内存
一个2GB的ISO文件，malloc 2GB内存不仅慢，还可能触发OOM killer（Linux）或抛 std::bad_alloc（Windows）。EVP接口本身支持流式更新，关键在怎么喂数据。
正确做法是分块读取，每次最多几KB，反复调 EVP_DigestUpdate。实测1MB块反而不如8KB快——磁盘顺序读的局部性更好，且避免大buffer带来的cache抖动。
- 用
file.read(buffer, sizeof(buffer))，然后检查file.gcount()获取真实读取字节数，别信file.eof() - 循环末尾加
if (!file) break;，防止读完最后一块后仍尝试read导致状态异常 - 如果文件路径含中文或特殊字符，Windows下需用
std::wifstream+_wfopen或 UTF-8 路径转换（取决于编译器和CRT）
跨平台编译时注意OpenSSL链接方式
Linux上通常 -lssl -lcrypto 就够；macOS用Homebrew装的OpenSSL 3.x，默认头文件在 /opt/homebrew/include，链接库在 /opt/homebrew/lib，不加 -I 和 -L 会报 openssl/evp.h: No such file。
Windows MSVC下更麻烦：OpenSSL静态库（libcrypto.lib）依赖 ws2_32.lib 和 crypt32.lib，漏一个就报LNK2019；若用动态DLL，还要确保运行时能找到 libcrypto-3.dll（通常放exe同目录）。
- CMake里推荐用
find_package(OpenSSL REQUIRED)，它自动处理路径和依赖项 - MinGW-w64 用户注意：部分发行版默认带旧版OpenSSL 1.0，
EVP_MD_CTX_new等新API不可用，得手动编译OpenSSL 1.1.1+ - Clang on macOS：如果用
-stdlib=libc++，OpenSSL必须用相同标准库编译，否则std::stringABI不兼容，运行时报段错误
验证结果是否正确的快速办法
别只靠打印十六进制字符串——容易看花眼。最简单的是拿已知哈希的测试文件（比如空文件SHA256是 e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855）跑一遍，再用命令行交叉验证：
sha256sum test.txt # Linux/macOS certutil -hashfile test.txt SHA256 # Windows
注意：Windows certutil 输出带空格和冒号，要手动去掉；macOS shasum -a 256 默认输出格式和OpenSSL一致，可直接比对。
真正容易被忽略的是文件末尾的BOM（UTF-8 with BOM）或隐藏控制字符——它们算进文件内容，但肉眼看不见。调试时建议先用 xxd -p test.txt | head -c 64 看原始字节，确认输入确实是你以为的那些字节。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
