base32 编码不能逐字节查表，必须将输入视为连续比特流、每5位一组切分；否则跨字节边界错位，导致查表索引错误、补零失效或越界访问，正确实现需用 uint64_t 位缓存+静态查表+预分配输出缓冲。
直接用 std::string 逐字节转查表会错——Base32 不是字节映射，而是比特流重分组，必须按 5 位切分，否则 “hello” 编码出 MFRGG=== 还是 MFRGG==? 都不可控。
为什么不能把 std::string 当字节数组直接 for 循环查表
因为 ASCII 字节是 8 位，Base32 要求输入视为连续比特流，从左到右每 5 位一组取值。比如 "ab" 是 0x61 0x62 → 0b0110000101100010（16 位），需补 4 个 0 到 20 位，再拆成 4 组 5 位：01100 00101 10001 0xxxx → 补零后为 01100 00101 10001 00000。硬按字节循环会跳过跨字节边界，导致第二组取到错误的 00001 而不是 00101。
- 错误现象：
base32_encode("a")返回ME======（6 个 =）是合法的，但若实现没做末尾位移对齐，可能返回ME======（看似一样，实则补位逻辑失效） - 所有输入字节必须先转
unsigned char，否则在有符号char平台（如 GCC 默认）上，\xFF右移会产生算术移位，高位补 1 - 查表前不做
& 0x1F截断，高位垃圾位会导致越界访问
如何用位运算 + 静态查表做到零堆分配编码
核心是用一个 uint64_t 当位缓存，用 bit_pos 记录当前已写入多少位，每次从输入字节中取剩余位填入高位，凑够 5 位就查表输出。不 new、不 push_back、不 resize 中间 buffer。
- 查表必须是
static constexpr char table[32]，例如："ABCDEFGHIJKLMNOPQRSTUVWXYZ234567"（RFC 4648 标准） - 输出缓冲长度要预计算：
((input_len * 8 + 4) / 5)向上取整，再向上取整到 8 的倍数（因 Base32 输出总长必为 8 的倍数） - 关键位操作：每次取
(bits >> 59) & 0x1F（因bits左对齐，高 5 位即有效索引），然后bits - 末尾填充
=数量由input_len % 5决定：余数为 0/1/2/3/4 → 填充 0/6/4/3/1 个=，直接调output.resize(expected_len)
解码时怎么安全处理填充和非法字符
解码比编码更易崩溃：填充符位置错误、大小写混用、非查表字符（如 0、1、/）都得拒绝。不能靠 std::find 查表——太慢，要用静态反向映射数组。
- 反向映射表大小至少 128 字节（覆盖 ASCII），未定义字符设为 255；例如
reverse_map['A'] = 0，reverse_map['Z'] = 25，reverse_map['2'] = 26 - 遇到
=必须只出现在末尾，且数量只能是 0/1/3/4/6；中间出现或数量不对就抛std::invalid_argument - 解码输出长度固定：
fromBase32Length(encoded_len) = (encoded_len * 5) / 8（向下取整），但最后 1 字节可能被补零截断，需根据实际填充数修正 - 输入含空格、换行、小写字母？先统一转大写 or 拒绝——RFC 4648 明确要求大小写敏感，
a和A是不同字符
最易被忽略的是：补零只发生在比特流末尾，不是字节末尾；查表前没强制 unsigned char 转换会在某些平台静默出错；填充数量不校验会导致解码后多出垃圾字节。这些点不卡死，上线后可能只在特定输入下崩一次，极难复现。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
