Counter 初始化需传可迭代对象，不可传单个数字；most_common() 返回tuple列表，索引取值需防空；支持算术运算但减法剔除非正计数；keys()/elements()等返回视图或迭代器，非list。
Counter 初始化时传 list、str、dict 都行，但别直接传单个数字
Python Counter 不是数学计数器，它只对可迭代对象里每个元素做频次统计。传 123 会报 TypeError: 'int' object is not iterable；传 "123" 却可以——因为字符串是可迭代的，结果是 Counter({'1': 1, '2': 1, '3': 1})。
常见误用场景：想统计某个数字出现次数，却写成 Counter(42)；或从数据库取了一列 ID（list[int]），直接喂给 Counter 是 OK 的，但若混了 None，它也会当一个独立元素计一次。
- 正确做法：确保输入是可迭代对象，比如
Counter([1, 2, 2, 3])、Counter("abac")、Counter({"a": 2, "b": 1}) - 注意
dict初始化方式：键是元素，值是「预设频次」，不是原始数据；它不会帮你遍历 dict 的 value 再统计 - 如果源头是生成器（如文件逐行读取），建议先转成
list或用Counter(line.strip() for line in f)，避免生成器耗尽后二次调用失败
most_common() 返回 tuple 列表，不是 dict，索引取值要小心
most_common() 返回的是 list[tuple[element, count]]，不是 dict，也不是 Counter 对象本身。很多人想直接 c["most_frequent"] 或 c.most_common()[0].key，都会错。
典型错误现象：AttributeError: 'tuple' object has no attribute 'key'；或者写 c.most_common(1)[0][0] 拿到最多元素，但没考虑空 Counter 场景——most_common(0) 或空数据下 most_common() 返回空列表，[0] 会触发 IndexError。
立即学习“Python免费学习笔记（深入）”；
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
- 安全取 top1 元素：
top = c.most_common(1)[0][0] if c else None - 要前 3 名且允许少于 3 个？直接
c.most_common(3)就行，不用手动切片 -
most_common(n)性能是 O(n log n)，n 很大时（比如要 top 10000）不如用堆手动优化，但日常够用
Counter 支持 + - & | 运算符，但减法不支持负数计数
Counter 重载了算术运算符，看着像集合操作，实际语义不同：+ 是各元素计数相加；- 是相减，但结果中计数 ≤ 0 的元素会被自动剔除（不是保留为 0 或负数）；& 取最小值，| 取最大值。
容易踩的坑：以为 c1 - c2 能表示“差集”，结果发现 c1 = Counter(a=3), c2 = Counter(a=5) 算完是空 Counter()，而不是 Counter(a=-2)；还有人拿 Counter 做带符号的频次差值分析，必须自己手动处理逻辑。
- 需要保留零/负计数？别用
-，改用字典推导：Counter({k: c1[k] - c2[k] for k in set(c1) | set(c2)}) -
update()是就地加法，等价于+=；subtract()是就地减法，但同样会丢弃 ≤ 0 的项 - 两个
Counter做&或|时，只对共有的 key 计算，没有的 key 不参与——这点和dict合并行为不同
Counter 不是 dict 子类，但行为高度兼容；不过 .keys()/.values() 返回视图，不是 list
Counter 继承自 dict，所以能用 in、.get()、.items() 等，但它的 .elements() 方法返回的是迭代器，不是 list；.keys() 和 .values() 返回的是视图对象（KeysView/ValuesView），不能直接索引，也不能保证顺序（尽管通常按插入顺序）。
典型问题：写 c.keys()[0] 报 TypeError: 'dict_keys' object is not subscriptable；或以为 c.elements() 是 list，结果用 len() 或 [::2] 失败。
- 要转 list？显式调用
list(c.keys())、list(c.elements()) - 要按频次排序遍历？别依赖
.keys()顺序，用c.most_common()更可靠 - 兼容性注意：Python 3.7+
dict保持插入序，Counter也如此；但旧版本不保证，别在循环里依赖遍历顺序
Counter 最难绷的点其实是「它看起来像 dict，用起来像 list，但既不是 dict 也不是 list」——所有你以为顺手的直觉操作，最好查一眼文档确认返回类型。比如 .elements() 返回迭代器，一次耗尽；你调两次，第二次啥也不 yield。
