优先选用Boost.Beast的boost::beast::detail::base64::decode（轻量、头文件仅依赖、自动校验填充与非法字符）或OpenSSL的EVP_DecodeBlock（通用性强，需手动清洗空白、补填充并计算真实长度）；二者均优于手写实现。
Base64 解码函数选哪个？别直接手写
标准 C++ 库不提供 base64_decode，硬啃 RFC 4648 手写容易漏掉填充字符处理、非法字符校验、字节对齐等边界情况。推荐用成熟实现：Boost 的 boost::beast::detail::base64::decode（轻量，头文件仅依赖），或更通用的 openssl/evp.h 中的 EVP_DecodeBlock。若项目已用 Boost，优先选 Beast 模块——它不带 OpenSSL 链接开销，且 API 简洁。
用 Boost.Beast 解码时，输入字符串末尾的 '=' 必须保留
Base64 编码末尾的填充字符 = 不是可选的装饰，而是用于还原原始长度的关键信息。丢掉会导致解码后字节数错误，甚至触发断言失败。Beast 的 boost::beast::detail::base64::decode 会检查输入长度是否为 4 的倍数，并验证填充位置是否合法（最多两个 =，且只在末尾）。
常见错误现象：
- 输入 "YWJj"（正确）→ 输出 3 字节
- 输入 "YWJj" 但误删了隐式填充 → 实际仍是 4 字符，没问题；但若传入 "YWJ"（缺填充）→ 解码失败，返回空 std::vector<:uint8_t></:uint8_t>
- 输入 "YWJj=="（冗余填充）→ 解码失败，因为 Base64 规定最多两个 =，且必须紧贴末尾
实操建议：
- 用 std::string_view 接收输入，避免意外修改
- 解码前先做简单校验：input.size() % 4 == 0，且末尾最多两个 =，中间不含 =
- 示例调用：
std::vector<std::uint8_t> decoded = boost::beast::detail::base64::decode(input);
OpenSSL 解码需手动处理长度与内存管理
EVP_DecodeBlock 不自动处理填充，也不返回实际解码长度——它只把结果写入你提供的缓冲区，并返回“理论”字节数（未考虑填充）。你得自己算原始长度：len = input.size() * 3 / 4，再减去填充数（= 个数 × 0.75，向下取整）。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
容易踩的坑：
- 缓冲区大小设成 input.size() → 溢出，因为 Base64 每 4 字符解出 3 字节
- 忘记 EVP_DecodeBlock 会忽略末尾换行符，但你的输入若含 \n 或 \r（比如从 PEM 文件读取），必须先剔除
- 返回值为负数表示解码失败（如含非法字符 q、z），但不会告诉你哪错
实操建议：
- 分配缓冲区大小 = (input.size() + 3) / 4 * 3（向上取整到 3 的倍数）
- 调用前用 std::remove_if 清除空白：input.erase(std::remove_if(input.begin(), input.end(), ::isspace), input.end());
- 示例：
int out_len = EVP_DecodeBlock(decoded_buf, reinterpret_cast<const unsigned char*>(input.c_str()), input.size());
二进制数据里有 '\0'？别用 std::string 当容器
解码结果是原始字节流，可能含多个 \0。若存进 std::string，后续用 c_str() 或 data() 会被截断——C 字符串语义只认第一个 \0。这是最隐蔽也最常被忽略的问题。
立即学习“C++免费学习笔记（深入）”；
正确做法：
- 用 std::vector<:uint8_t></:uint8_t> 存原始字节（Boost.Beast 默认返回这个）
- 若必须转 std::string，用带长度的构造：std::string s(decoded.begin(), decoded.end())，而非 std::string(decoded.data(), decoded.size())（后者在 decoded.data() 含 \0 时行为未定义）
- 读写文件时，务必以 binary 模式打开：std::ofstream f("out.bin", std::ios::binary)
性能提示：std::vector<:uint8_t></:uint8_t> 和 std::string 内存布局相同，只是语义不同。只要不用 C 接口，两者开销一致。
