Base64解码函数应返回std::vector<uint8_t>，因其准确表示二进制数据；用std::string易因\0截断、长度误判导致bug，如"AA=="解码后size()为0。
Base64解码函数返回std::vector<uint8_t></uint8_t>还是std::string？
解码结果本质是二进制数据，不是文本——哪怕原始数据恰好是UTF-8字符串。用std::string存储容易出问题：某些字节（如\0）会提前截断，且.size()和.length()在含空字节时不可靠。强烈建议直接返回std::vector<uint8_t></uint8_t>，避免隐式类型转换和边界误判。
常见错误现象：std::string decoded = base64_decode("AA==");后decoded.size() == 0（因为首字节是\0）；或后续传给memcpy时长度计算错误。
- 解码函数签名应为：
std::vector<uint8_t> base64_decode(const std::string& encoded)</uint8_t> - 若必须用
std::string，需用std::string(data.begin(), data.end())构造，且调用方必须用.data()和.size()访问原始字节 - 别依赖
std::string::c_str()——它返回以\0结尾的指针，对二进制数据无效
如何处理Base64填充字符=和非法字符？
标准Base64编码末尾可能有1–2个=，用于补齐长度。解码时必须校验：有效输入长度必须是4的倍数，且=只能出现在末尾、最多两个。遇到=位置不对（如中间出现）、非Base64字符（如!、空格、换行）时，应直接返回空结果或抛异常，而不是静默忽略——否则可能解出错误字节流。
典型场景：从HTTP头或JSON字段读取Base64字符串时，常混入换行符或多余空格。
立即学习“C++免费学习笔记（深入）”；
- 预处理：用
encoded.erase(std::remove_if(encoded.begin(), encoded.end(), ::isspace), encoded.end());清理空白 - 长度检查：
if (encoded.length() % 4 != 0) return {}; - 填充校验：若末尾有
=，只允许1–2个，且encoded.substr(encoded.length()-2) == "=="或encoded.back() == '=' - 查表时对非法字符返回
-1，遇到-1立即终止解码
查表实现比std::stoi或switch快多少？
查表（64元素数组）是唯一实用方案。用std::stoi解析每个字符是灾难性的——要构造子串、抛异常、无法内联；switch虽可行，但编译器未必优化成跳转表，且代码冗长。查表访问是O(1)内存访问，现代CPU缓存友好。
性能影响：对1MB Base64数据，查表解码约耗时0.5ms，switch约1.2ms，std::stoi超20ms且频繁异常开销。
- 静态查表声明：
static constexpr std::array<int8_t> kBase64Table = []{ /* 初始化 */ }();</int8_t> - 索引用
static_cast<unsigned char>(c)</unsigned>避免负值下标（如char为signed时0xFF变-1） - 表中非Base64字符设为
-1，解码循环中遇到即return {};
为什么解码后字节数是encoded.length() * 3 / 4？
Base64每4字符编码3字节原始数据，所以理论输出长度是len * 3 / 4。但因填充字符=不贡献数据，实际需减去填充数：每1个=少1字节，2个=少2字节。例如"AQ=="（4字符）解码得1字节，不是3字节。
容易踩的坑：直接resize(encoded.length() * 3 / 4)会多分配内存，且未考虑填充；更糟的是用reserve()却不resize()，导致写越界。
- 正确计算：
size_t out_len = encoded.length() / 4 * 3;，再减去=个数（0/1/2） - 分配缓冲区：
std::vector<uint8_t> out(out_len);</uint8_t>，然后按块填入 - 每个4字符块解出3字节：取4个索引值
a,b,c,d，计算(a，再拆成3个字节
最易被忽略的是：Base64解码本身不涉及字符编码转换（如UTF-8），它只是二进制到ASCII的映射。如果你拿到的是“Base64编码的UTF-8字符串”，解码后得到的就是原始UTF-8字节流——要不要转成std::u8string或宽字符，是后续步骤，和Base64解码无关。
