哈夫曼树构建必须用最小堆优先队列，避免O(n²)退化；编码需DFS递归生成，解码须逐位匹配；单字符输入编码为"0"，空频次表需提前判空；字符统计须转unsigned char防越界。
哈夫曼树构建必须用优先队列，不能手写排序合并
手动维护节点列表并每次找最小两个权值节点，时间复杂度会退化到 O(n²)，尤其在字符集大（如 256 字节）时明显卡顿。C++ 标准库的 std::priority_queue 默认是最大堆，得用 std::greater 反转成最小堆；节点比较逻辑必须重载 operator 或传自定义仿函数，否则所有节点会被当成相同优先级。
常见错误是直接把 char 和 int 塞进队列却不封装——必须定义结构体或类，包含权值、字符（叶子）、左右子指针，并确保比较只基于权值：
struct Node {
int freq;
char ch;
Node* left;
Node* right;
Node(int f, char c) : freq(f), ch(c), left(nullptr), right(nullptr) {}
};
auto cmp = [](Node* a, Node* b) { return a->freq > b->freq; };
std::priority_queue<Node*, std::vector<Node*>, decltype(cmp)> pq(cmp);
生成前缀码要用递归回溯，不能靠父指针遍历
哈夫曼编码本质是根到叶子的路径编码，0/1 分别对应左/右分支。如果树节点没存父指针，强行从叶子往上找路径不仅逻辑绕、还容易空指针崩溃；更糟的是，有些实现试图用 BFS 层序编号模拟路径，结果生成的码字不满足前缀性质（比如 '01' 和 '011' 同时出现）。
正确做法是 DFS 递归向下传递当前编码字符串，遇到叶子就存入 std::map<char std::string></char>：
立即学习“C++免费学习笔记（深入）”；
- 递归入口传空字符串，每进左子树追加
'0'，进右子树追加'1' - 只在
node->left == nullptr && node->right == nullptr时记录map[node->ch] = code - 务必检查输入字符是否全为叶子节点——若原始频次表含 0 频次字符，可能漏建叶子，导致 map 查不到键
编码输出要区分“无重复字符”和“全零频次”两种边界情况
当输入字符串只有一个字符（如 "aaaa"），哈夫曼树退化成单节点：此时无法分配 0/1 编码，硬编会导致解码歧义。标准做法是强制设编码为 "0"（不是空字符串），并在解码端特殊处理。
另一个坑是频次全为 0 的输入（如空字符串或全控制字符）。std::priority_queue 构建阶段会直接为空，后续调用 pq.top() 崩溃。需在建树前检查：
- 若频次容器（如
std::map<char int></char>）size 为 0，直接返回空编码表 - 若 size 为 1，跳过合并循环，直接 new 一个叶子节点
- 不要依赖
freq > 0过滤——某些场景需保留 '\0' 等零值字符，应由上层业务决定是否过滤
解码时必须用 while 循环逐位匹配，不能预分割码流
有人把编码字符串按最长码长切片（如取前 8 位），再查表匹配，这在哈夫曼码中完全错误：因为码长不等，'0' 可能本身就是某个字符的编码，提前截断就永远匹配不到。
正确解码逻辑是边读边比，用一个临时字符串累积比特，每次追加一位后查 map，命中即清空临时串、输出字符：
std::string bits = "0101100..."; // 编码后的二进制字符串
std::string cur = "";
std::string decoded;
for (char b : bits) {
cur += b;
auto it = codeMap.find(cur);
if (it != codeMap.end()) {
decoded += it->second;
cur.clear();
}
}
这里 codeMap 是 std::map<:string char></:string>，反向映射用于解码。注意：如果编码流损坏或存在非法比特序列，cur 会不断增长直至超长——实际应用中应加长度保护（如 > 32 位直接报错）。
真正难调试的点往往不在算法主干，而在字符编码隐含的 signed/unsigned 差异：读文件时若用 char 当数组下标去查频次表，遇到高位为 1 的字节（如 UTF-8 中文）会变负数索引，导致越界或静默错位。稳妥做法是强转为 unsigned char 再映射。
