Base64编码必须严格遵循RFC 4648标准字符序ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/，错一位即导致解码失败；编码需补'='使长度为4的倍数（余1补2个、余2补1个），解码时'='须连续位于末尾且总数≤2，非法字符须报错而非跳过。
Base64编码表和索引映射必须严格对齐标准
Base64不是随便选64个字符拼起来就行——ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/ 这个顺序是RFC 4648规定的，错一位解码就全乱。常见坑是把'+'和'/'写反，或者用'_''-'（那是URL-safe变种，不兼容标准Base64）。C++里建议直接定义为const char kBase64Table[65]（末尾加'\0'方便std::string构造），查表时用static_cast<unsigned char></unsigned>转，避免负值索引越界。
输入字符串长度不是4的倍数时要补'='并校验
Base64编码后长度必为4的倍数，不足则用'='填充；解码时遇到'='必须在末尾，且只允许0/1/2个。实操中容易漏掉这两条：
• 编码末尾补'='前，先算len % 3：余1补2个'='，余2补1个；
• 解码时遍历到'='就立刻停止，并检查其位置是否在最后1~2位、总数是否≤2；
• 若输入含非法字符（如空格、换行），应提前过滤或报错，不能静默跳过。
三字节→四字节转换时注意字节序和位移边界
每3个原始字节（24位）拆成4组6位，按高位到低位取：第一个Base64字符取(bytes[0] >> 2)，第二个取((bytes[0] & 0x03) > 4)……关键点：
• 每次位运算前确保bytes[i]是unsigned char，否则符号扩展会出错；
• 最后一组若原始不足3字节（比如只剩1字节），后两个Base64字符对应部分用0填充，但解码时得按实际字节数截断输出；
• 不要用std::vector<char></char>直接push_back再转string，避免末尾多出
每3个原始字节（24位）拆成4组6位，按高位到低位取：第一个Base64字符取(bytes[0] >> 2)，第二个取((bytes[0] & 0x03) > 4)……关键点：
• 每次位运算前确保bytes[i]是unsigned char，否则符号扩展会出错；
• 最后一组若原始不足3字节（比如只剩1字节），后两个Base64字符对应部分用0填充，但解码时得按实际字节数截断输出；
• 不要用std::vector<char></char>直接push_back再转string，避免末尾多出\0。
std::string传参和返回要明确是否含\0
Base64处理的是二进制数据的文本表示，输入std::string可能含\0（比如读文件二进制内容），此时不能用c_str()或data()配合strlen——会截断。正确做法：
• 编码函数签名用std::string base64_encode(const std::string& in)，内部用in.size()；
• 解码函数返回std::string，构造时显式指定长度：return std::string(out_buf, out_len)；
• 如果调用方传入带\0的std::string，确保它本身.size()准确，而不是靠C风格字符串函数推断。
细节上最易被忽略的是：解码时对填充字符'='的校验逻辑，很多人只检查个数，却没验证它们是否连续出现在末尾——中间出现'='就是非法输入，该直接返回错误。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
