base64编码的本质是将二进制字节流按每3字节分组，转为4个6位值并映射到64字符表，需显式传入长度、以unsigned char处理、严格校验填充与非法字符。
Base64编码的本质是字节流处理，不是字符串处理
很多人一上来就用 std::string 或 C 风格字符串（char[]）直接喂给 Base64 函数，结果乱码或截断——因为 Base64 编码对象是原始字节（unsigned char），而 C++ 字符数组若含 \0 会被当成 C 字符串提前终止；更糟的是，如果数组里有负值（如 char c = 0xFF），直接当 int 移位会符号扩展，导致编码错误。
所以第一步永远是：把输入当作一串 unsigned char 看待，长度必须显式传入，不能依赖 strlen 或 .size()。
- 输入源是
char data[1024]？先 cast 成const unsigned char* - 输入来自
std::vector<char></char>？取data()并转为const unsigned char* - 千万别对含二进制内容的
char[]调用std::string(data)—— 遇到\0就停
查表编码比手算快且安全，但查表要自己定义
C++ 标准库不提供 Base64，得自己实现或用轻量库。手动写编码逻辑时，别现场算 (b >> 2) & 0x3F 这类位运算——容易出错，也难调试。推荐用静态查表 + 显式分块处理。
Base64 字符集是确定的："ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/"，共 64 个字符。编码时每 3 字节（24 bit）拆成 4 组 6 bit，每组查一次表。
- 查表数组声明为
static constexpr char kBase64Table[64]，避免运行时构造开销 - 每次处理 3 字节一组：剩余不足 3 字节时，用
=补位，且只补 1 或 2 个（对应输入长度 % 3 == 1 或 2） - 注意：最后一组若只有 1 字节输入（即 len % 3 == 1），实际只生成 2 个 Base64 字符 + 2 个
=；2 字节输入则生成 3 个字符 + 1 个=
// 示例：核心编码循环片段（假设 in 是 const unsigned char*, len 是 size_t） std::string out; out.reserve((len + 2) / 3 * 4); // 预分配，避免反复 realloc for (size_t i = 0; i = 1) val |= (uint32_t)in[i] = 2) val |= (uint32_t)in[i + 1] = 3) val |= (uint32_t)in[i + 2]; <pre class="brush:php;toolbar:false;">out.push_back(kBase64Table[(val >> 18) & 0x3F]); out.push_back(chunk_size >= 1 ? kBase64Table[(val >> 12) & 0x3F] : '='); out.push_back(chunk_size >= 2 ? kBase64Table[(val >> 6) & 0x3F] : '='); out.push_back(chunk_size >= 3 ? kBase64Table[val & 0x3F] : '=');
}
解码时务必校验非法字符和补位位置
编码可宽松，解码必须严格。常见坑是把空格、换行、非 Base64 字符（如 _ 或 -）直接忽略——这在 URL-safe 变种里才允许，标准 Base64 不认。遇到非法字符应立即报错，而不是跳过。
- 补位符
=只能出现在末尾，且最多连续 2 个；中间出现=就是非法输入 - 查表解码时，对每个输入字符先查
uint8_t index = kBase64DecodeTable[c]，若值为 255 表示非法字符 -
kBase64DecodeTable是 256 元素数组，初始化时把 A-Z/a-z/0-9/+// 对应位置设为 0–63，其余全设为 255 - 解码输出长度 =
(input_len * 3) / 4，再减去补位数（1 或 2 个=各减 1 字节）
用 std::array 或 std::vector 替代裸 char[] 更安全
如果你控制得了输入来源，别用 char buffer[1024] 这种裸数组做 Base64 输入——它没长度信息，容易越界；也不方便传给函数。现代 C++ 下更推荐：
- 输入是已知长度的二进制数据 → 用
std::vector<unsigned char></unsigned>，天然带.data()和.size() - 输入是编译期固定小数据 → 用
std::array<unsigned char n></unsigned>，零开销且类型安全 - 必须接 C API 返回的
char*和长度 → 立刻封装成std::span<const unsigned char></const>（C++20）或自定义 view 类
裸 char[] 唯一合理场景是嵌入式或极端性能约束，此时你得自己确保长度正确、无符号语义、无隐式截断——这些细节，恰恰是 Base64 错误最密集的地方。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
