应手写轻量Base64编码函数：分组查表补等号，用static const char数组查表，正确处理末尾对齐（%3==1补两个=，%3==2补一个=），避免OpenSSL、不存在的std::base64encode及低效操作。
Base64编码函数该用哪个：std::string → std::string 最简路径
标准库不提供 Base64 编码，得自己实现或用轻量第三方。别碰 OpenSSL 的 EVP_EncodeBlock——它要求输入长度是 3 的倍数、输出缓冲区要预分配、还带一堆上下文管理，纯属给加解密流程设计的，不是为字符串转码准备的。
推荐手写一个只处理 std::string 的版本，核心逻辑就三步：分组、查表、补等号。关键点在于处理非 3 字节对齐的末尾：
- 输入长度 % 3 == 1 → 补两个
= - 输入长度 % 3 == 2 → 补一个
= - 查表用 const char 数组比 std::map 快得多，且无内存分配
示例片段（仅示意逻辑）：
static const char base64_chars[] = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";<br>std::string encode(const std::string& s) {<br> std::string out;<br> int val = 0, valb = -6;<br> for (unsigned char c : s) {<br> val = (val << 8) + c;<br> valb += 8;<br> while (valb >= 0) {<br> out.push_back(base64_chars[(val >> valb) & 0x3F]);<br> valb -= 6;<br> }<br> }<br> if (valb > -6) out.push_back(base64_chars[((val << 8) >> (valb + 8)) & 0x3F]);<br> while (out.size() % 4) out.push_back('=');<br> return out;<br>}
为什么不能直接用 std::base64encode（C++20）？
因为根本不存在 std::base64encode。C++20 没加入任何 Base64 相关设施，网上搜到的所谓“C++20 Base64”全是误传或第三方库 alias。别在项目里写 using namespace std; std::base64encode(...)——编译不过，IDE 可能靠头文件提示骗你，但链接时铁定失败。
立即学习“C++免费学习笔记（深入）”；
真正进标准的是 C++23 的 std::ranges::to 和视图适配器，但 Base64 还没影。目前最稳的跨平台方案仍是自己写 50 行以内的编码器，或引入 boost/algorithm/string/encode.hpp（注意它叫 boost::algorithm::base64_encode，不是 boost::base64::encode）。
空字符、二进制数据、UTF-8 字符串怎么处理？
Base64 本质是字节编码，和文本编码无关。只要把 std::string 当作字节数组传进去就行——哪怕里面含 \0、\xFF 或 UTF-8 多字节序列，都不影响编码结果。但要注意：
- 别用
c_str()后取strlen()算长度，会截断在第一个\0 - 务必用
s.data()+s.size()获取原始字节和长度 - 如果源是
std::u8string（C++20），先转成std::string_view再编码，别用.c_str()
错误示范：
std::string utf8 = u8"你好";<br>// ❌ 错！strlen 截断<br>size_t len = strlen(utf8.c_str()); // len == 0？
正确做法：
auto data = reinterpret_cast<const unsigned char*>(utf8.data());<br>std::string encoded = encode(std::string_view{reinterpret_cast<const char*>(data), utf8.size()});
性能敏感场景下，哪些操作必须避免？
高频调用（如日志上报、HTTP header 构造）时，每轮 new/delete 或反复 resize string 是主要瓶颈：
- 别在 encode 函数里用
std::string out; out.reserve(…);—— reserve 不保证后续 push_back 不 realloc - 更优：传入 output buffer（
std::string& out），由调用方复用；或返回std::string_view指向静态缓冲区（仅限单线程+短生命周期） - 查表数组必须是 static const，否则每次调用都初始化，GCC/Clang 会优化掉，但 MSVC 在 Debug 下可能不优化
- 别用
std::vector<char></char>中转——多一次拷贝，不如直接 push_back 到 string
最容易被忽略的是等号填充逻辑：有人用 out += "==";，看似简洁，实则触发两次小字符串重分配。应统一用 out.append(2, '=') 或预计算好最终长度再 resize。
