c++标准库不提供sha256实现，必须依赖openssl或libsodium等第三方库；openssl需手动管理上下文，libsodium支持单函数调用；输入须传准确长度，输出为32字节二进制，hex编码需手动实现。
SHA256 在 C++ 里没有标准库实现
标准 C++（C++11/14/17/20/23）至今不提供 SHA256 或任何密码学哈希函数。别翻 <string></string>、<algorithm></algorithm> 或 <hash></hash>——它们全没用。你看到的所谓“C++ SHA256 教程”，实际都在调第三方库，不是语言原生能力。
常见误操作是直接搜 “C++ sha256 header”，结果引入非标准头文件（比如某些平台私有扩展），或误把 std::hash<:string></:string> 当成 SHA256（它只是快速但不安全的散列，碰撞多、不可逆、无固定长度）。
- 别写
#include <sha256.h></sha256.h>—— 标准中不存在这个头 - 别依赖编译器扩展（如 GCC 的
__builtin_sha256），它只在极少数 ARM 架构上存在，且非可移植 - 别用
std::hash替代：输出长度不定、不抗碰撞性、不满足 FIPS/PCI DSS 等合规要求
推荐用 OpenSSL（最稳）或 libsodium（最简）
生产环境首选 OpenSSL，因它被广泛审计、支持硬件加速、兼容 TLS/证书等生态；若只做简单哈希且想避免 OpenSSL 的复杂初始化和许可证顾虑，libsodium 更轻量（它把 crypto_hash_sha256 封装得像函数调用一样直白）。
二者关键差异：
立即学习“C++免费学习笔记（深入）”；
- OpenSSL 需手动管理
EVP_MD_CTX生命周期：EVP_MD_CTX_new()→EVP_DigestInit_ex()→EVP_DigestUpdate()→EVP_DigestFinal_ex()→EVP_MD_CTX_free() - libsodium 一行搞定：
crypto_hash_sha256(out, in, inlen)，out是 32 字节缓冲区 - OpenSSL 默认链接
libcrypto，Windows 下容易遇到 DLL 找不到错误；libsodium 是单头+单库，静态链接更干净
示例（OpenSSL）：
unsigned char hash[SHA256_DIGEST_LENGTH]; EVP_MD_CTX *ctx = EVP_MD_CTX_new(); EVP_DigestInit_ex(ctx, EVP_sha256(), NULL); EVP_DigestUpdate(ctx, "hello", 5); EVP_DigestFinal_ex(ctx, hash, NULL); EVP_MD_CTX_free(ctx); // hash[] 现在含 32 字节二进制结果
别忽略输入长度和内存安全边界
SHA256 输入理论上无限长，但实际调用时，传入的 in 指针必须有效，长度 inlen 必须准确——尤其处理 std::string 时，别直接传 s.c_str() 而不传 s.length()，否则遇到内部 \0 就截断。
-
std::string含二进制数据？用s.data()+s.size()，不用c_str() - 用
std::vector<uint8_t></uint8_t>存原始字节时，传v.data()和v.size()，别漏掉.size() - 输出缓冲区至少 32 字节：OpenSSL 写满 32 字节；libsodium 也要求
out至少 32 字节，不会自动分配 - 别把输出当 C 字符串用：
hash里可能含 \0，printf("%s", hash)会提前截断
Hex 编码要自己转，别指望库自动给字符串
所有主流 C++ 密码库返回的都是 32 字节二进制数据，不是 "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855" 这种 64 字符 hex 字符串。这一步必须手动做，且容易出错。
- 别循环用
sprintf(buf, "%02x", hash[i])——栈缓冲区溢出风险高 - 推荐用
std::ostringstream或范围 for +std::format（C++20） - 注意大小写：FIPS 要求小写 hex，但有些旧系统期望大写，确认下游约定
- 性能敏感场景（如日志高频打点），避免每次分配 string，可用预分配的
std::array<char></char>手动填充
小示例（C++17）：
std::string to_hex(const unsigned char* data, size_t len) {
std::string s(len * 2, ' ');
for (size_t i = 0; i < len; ++i)
sprintf(&s[2*i], "%02x", data[i]);
return s;
}
SHA256 计算本身很简单，真正卡住人的永远是链接、内存生命周期、二进制/文本边界这些“旁边的事”。尤其是 Windows 上 OpenSSL 的 DLL 路径、Android NDK 里 OpenSSL 版本碎片化、还有 hex 转换时大小写混用导致和 Python/JS 结果对不上——这些比算法本身花的时间多得多。
