Base64编码将每3字节（24位）拆为4组6位查表转换，使用固定字符表“ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/”，末尾按输入长度模3补0、1或2个“=”，须用unsigned char避免符号扩展，严格处理空输入、单/双字节等边界。
Base64编码原理与字符映射表必须手写
Base64不是加密，而是把每3个字节（24 bit）拆成4组6 bit，查表转成ASCII可打印字符。标准Base64表前62位是 A-Z、a-z、0-9，最后两位是 + 和 /；末尾填充用 =。不能靠记忆硬写，必须定义为常量数组，否则大小写或符号错一位，整个结果就失效。
常见错误：用错填充逻辑（比如对长度为1的输入只补1个 = 而不是2个），或查表时索引越界（如把 64 当作合法索引）。要严格按 RFC 4648 定义处理边界：
- 输入长度 % 3 == 0 → 无填充
- 输入长度 % 3 == 1 → 补2个
=（原数据仅1字节，对应2个6bit组，后2组无效） - 输入长度 % 3 == 2 → 补1个
=（原数据2字节，对应3个6bit组，第4组无效）
逐块处理时注意 unsigned char 强制转换
C++中 char 可能有符号，直接拿来做位运算会导致高位扩展出负数，比如 0xFF 变成 -1，右移后变成 0xFFFFFFFF，后续与掩码 0x3F 按位与就完全失真。必须把每个输入字节先转成 unsigned char 再参与计算。
实操建议：
立即学习“C++免费学习笔记（深入）”；
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 遍历输入字符串时，用
static_cast<unsigned char>(s[i])</unsigned>取值 - 三字节分组时，用
uint8_t或unsigned char类型变量暂存，避免隐式符号扩展 - 不要直接对
std::string::operator[]返回的char&做位移操作
编码函数需支持空输入和任意长度
很多手写实现只测试了“hello”这种典型用例，一遇到空字符串或单字节就崩溃或返回乱码。核心逻辑必须覆盖边界：
- 输入为空 → 输出为空字符串，不是
"=="或其他 - 输入长度为1 → 输出4字符，形如
"xxx="（最后1位是=） - 输入含 null 字符（
'\0'）→ 不应被std::string截断，因为 Base64 编码的是原始字节流，不是 C 风格字符串
示例关键片段：
std::string base64_encode(const std::string& s) {
if (s.empty()) return "";
std::string out;
out.reserve(((s.size() + 2) / 3) * 4); // 预分配，避免多次 realloc
static const char* table = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
for (size_t i = 0; i < s.size(); i += 3) {
unsigned char c0 = static_cast<unsigned char>(s[i]);
unsigned char c1 = (i + 1 < s.size()) ? static_cast<unsigned char>(s[i + 1]) : 0;
unsigned char c2 = (i + 2 < s.size()) ? static_cast<unsigned char>(s[i + 2]) : 0;
out.push_back(table[c0 >> 2]);
out.push_back(table[((c0 & 0x03) << 4) | (c1 >> 4)]);
out.push_back((i + 1 < s.size()) ? table[((c1 & 0x0F) << 2) | (c2 >> 6)] : '=');
out.push_back((i + 2 < s.size()) ? table[c2 & 0x3F] : '=');
}
return out;
}
解码验证比编码更易出错，但不在此题范围
题目只要求编码，但实际开发中，你很可能紧接着就要解码回来做校验。此时要注意：编码函数输出的 = 必须严格出现在末尾，且数量只能是0、1或2；中间出现 = 就是非法Base64。另外，标准Base64不允许换行或空格，如果后续要对接HTTP或JSON，得确认是否需要添加换行（如 PEM 格式每64字符加 \n）——这不属于Base64编码本身，是传输封装层的事。
最容易被忽略的一点：编码结果里不含任何非表内字符，比如把 + 写成 -（URL安全变种），或漏掉最后的 = 填充。调试时别只看前几个字符对不对，一定要比对完整长度和末尾填充数量。
