base64 编解码应使用 uint8_t + size_t 接口而非 const char 或 std::string，因原始数据是字节流而非 c 字符串；decode 必须返回 std::vector 以避免 \0 截断，encode 可安全返回 std::string；查表解码应采用 constexpr std::array 而非 std::map。
base64_decode 和 base64_encode 函数本身不依赖指针语义，但用指针传参是安全、高效且符合底层意图的正确做法——尤其当输入是原始二进制数据（如图片、密文、网络包）时，std::string 容易隐式截断或触发无谓拷贝。
为什么不能直接传 const char* 给标准 Base64 解码函数？
很多网上示例写 base64_decode(const char* s)，看似简洁，实则埋雷：
— 若 s 指向含 \0 的二进制数据（比如从文件读出的密钥），strlen(s) 会提前截断；
— 若 s 是临时栈数组（如 char buf[1024]），没传长度就无法判断有效字符数；
— 更糟的是，某些实现内部用 std::string(s) 构造，等于主动把二进制流喂给文本容器，后续 .c_str() 或 std::cout 会静默失败。
base64_encode 应该接受 const uint8_t* 而非 const char*
原始数据本质是字节序列，不是 C 字符串。
— 接收 const uint8_t* data, size_t len 明确表达“这是 raw bytes”，避免误判 <p>原始数据本质是字节序列，不是 C 字符串。<br>— 接收 <code>const uint8_t* data, size_t len 明确表达“这是 raw bytes”，避免误判 \0 为结束符；
— 返回 std::string 是安全的，因为 Base64 输出只含 ASCII 可打印字符（A–Z, a–z, 0–9, +, /, =），不含控制符；
— 不要写 base64_encode(const std::string&)：它会强制拷贝，且 std::string 的 .data() 在 C++11 前不保证以 \0 结尾，可能引发 UB。
— 返回
std::string 是安全的，因为 Base64 输出只含 ASCII 可打印字符（A–Z, a–z, 0–9, +, /, =），不含控制符；— 不要写
base64_encode(const std::string&)：它会强制拷贝，且 std::string 的 .data() 在 C++11 前不保证以 <p>原始数据本质是字节序列，不是 C 字符串。<br>— 接收 <code>const uint8_t* data, size_t len 明确表达“这是 raw bytes”，避免误判 \0 为结束符；— 返回
std::string 是安全的，因为 Base64 输出只含 ASCII 可打印字符（A–Z, a–z, 0–9, +, /, =），不含控制符；— 不要写
base64_encode(const std::string&)：它会强制拷贝，且 std::string 的 .data() 在 C++11 前不保证以 \0 结尾，可能引发 UB。 结尾，可能引发 UB。
base64_decode 必须返回 std::vector<uint8_t></uint8_t>，不能是 std::string
解码结果是任意二进制流，\0、高位字节（如 UTF-8 中的 \xc3\xa9）、加密密文都合法。
— 若返回 std::string，下游代码调用 .c_str()、.size() 或传给 OpenSSL API 时，可能因 \0 截断或长度误判崩溃；
— 正确签名应为：std::vector<uint8_t> base64_decode(std::string_view encoded)</uint8_t>；
— std::string_view 避免构造临时 std::string，同时支持 C 字符串字面量、std::string、char* + len 等多种输入源；
— 若必须用指针接口（如对接 C API），提供重载：int base64_decode(const char* src, size_t src_len, uint8_t* dst, size_t* dst_len)，由调用方预分配缓冲区并传入容量。
查表解码时，const int8_t* 查表数组比 std::map 更快更安全
Base64 字符集固定 64 个，查表是 O(1)，而 std::map 是 O(log n) 且无法区分非法字符与合法字符 0。
— 推荐静态查表：static constexpr std::array<int8_t> s_base64_map = [...] </int8_t>，其中非法字符（空格、\r、\n、中文等）设为 -1；
— 解码循环中直接索引：int idx = s_base64_map[static_cast<uint8_t>(c)]</uint8_t>；
— 若 idx == -1，立即报错或跳过（取决于策略），避免静默错误；
— 不要用 std::map<char int></char>：每次查找引入红黑树开销，且对非法字符返回 0（而 ‘A’ 对应索引 0），导致乱码难排查。
真正麻烦的从来不是位运算逻辑，而是指针背后的数据语义是否清晰。传 uint8_t* + size_t 是告诉编译器和同事：“这是一段 raw bytes，别当字符串处理”。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
