C++20标准库不提供std::base64_encode或std::base64_decode，提案P0755已被搁置；推荐使用cppcodec（header-only）或OpenSSL（需正确初始化和错误处理），手写实现须严格遵循RFC4648的padding与查表规则。
std::base64_encode 不存在，别白找标准库函数
C++20 标准库压根没加 std::base64_encode 或 std::base64_decode。网上搜到的“C++20 Base64”基本是误传，或是把提案（P0755）当成了已实现特性。想用标准库原生支持？目前不可能。
常见错误现象：error: 'base64_encode' is not a member of 'std'，或者编译器报 std::ranges::encode 不存在——那是别人自己写的命名空间，不是标准。
- 真正进标准的是
std::format、std::span这类，Base64 连 TS 都没进 - 提案 P0755 已被搁置，短期内不会落地
- 别在
<string></string>、<codecvt></codecvt>（已弃用）里翻了，徒劳
推荐用 Boost.Compute 或 cppcodec 做轻量替代
Boost.Compute 不行——它专注 GPU 计算，没编解码；真正靠谱的是 cppcodec（header-only）或 boost/serialization/config.hpp 附带的 base64 实现（但不推荐直接用，太深）。
使用场景：嵌入式受限环境、不想引入 OpenSSL、只需单文件集成。
立即学习“C++免费学习笔记（深入）”；
-
cppcodec支持多种变体：base64_rfc4648（默认）、base64_url_unpadded，注意选错会解不出 - 示例片段（需
#include <cppcodec></cppcodec>）：std::string encoded = cppcodec::base64_rfc4648::encode("hello"); // "aGVsbG8=" - 解码失败时返回空字符串，不抛异常，得手动检查
encoded.empty()或用decode_result类型
OpenSSL 的 EVP 接口最稳，但链接和初始化容易漏
生产环境首选 OpenSSL，但坑在初始化和错误处理上。很多人调 EVP_EncodeBlock 成功，一换 EVP_DecodeBlock 就崩，其实是忘了输入长度必须是 4 的倍数，且含合法 Base64 字符（含 = 补位）。
- 必须调
OPENSSL_init_crypto(OPENSSL_INIT_ATFORK, nullptr)（1.1.1+），否则多线程下可能死锁 -
EVP_DecodeBlock会自动忽略换行、空格，但遇到非法字符（如_在 RFC4648 中非法）直接返回 -1 - 输出缓冲区大小要留足：
decoded_len = 3 * (encoded_len / 4)，别硬写strlen(encoded) * 3 / 4，没考虑补位 - 错误检查不能只看返回值：还要
ERR_get_error()，否则定位不到是 padding 错还是字符非法
自己手写编解码要注意查表和边界对齐
如果项目禁用第三方、又不愿链 OpenSSL，手写可行，但 64 字符查表 + 3→4 分组逻辑必须严丝合缝。最容易错的是末尾补位处理和字节序假设。
- 编码时，每 3 字节输入生成 4 字节输出；不足 3 字节必须补
=，且补的数量只能是 0/1/2 - 解码时，遇到
=就停止读取，并按数量反推丢弃多少字节（1 个=→ 丢最后 1 字节，2 个 → 丢最后 2 字节） - 别用
std::stoi解单字符——性能差还易溢出；用预建的char_to_val[256]查表，未定义字符设为 255 - 输入含换行符（如 PEM）？先
erase(remove_if(... isspace), ...)，否则查表会命中空格对应位置（值为 0，变成有效字符）
Base64 看似简单，但 padding 规则、URL 变体、多线程初始化、非法字符静默失败——这些点任何一个漏掉，都会让数据在某个边缘 case 下无声损坏。尤其服务端长期运行时，OpenSSL 初始化漏掉一次，后续所有 decode 就可能卡住或返回垃圾值。
