Python字典:你以为你全会了,但这10个坑90%的人踩过

上周组里新来的小姑娘写了一段代码，需求是从嵌套字典中提取用户信息。

她连续写了四层 .get()，每一层都配置了默认值，代码逻辑完全没问题，就是那一行代码拉得极长，像一列笔直的火车。

我问她：你试过 defaultdict 吗？她摇了摇头。

我又问：字典的 | 合并运算符了解吗？还是摇头。

这真的不是她的问题。

Python 字典太过常用，常用到每个开发者都默认自己已经完全掌握。可真正落地到工程项目、线上生产环境，栽在字典上的坑、报的错，数不胜数。

今天不讲 d = {"name": "Tom"} 这种入门基础，专门整理10个看似基础、实则极易踩坑、生产环境真实致命的字典问题。

这些坑不会让程序当场崩溃报错，但会悄悄埋雷，在你最意想不到的时候爆出线上问题。

【文末附完整版教程】

坑1：遍历字典时修改，直接炸

这个坑看起来低级，但在实际项目里出现的频率高得离谱。

你在遍历一个字典，发现某些key不满足条件，想顺手删掉：

第二种会创建新字典，数据量大的时候内存开销翻倍。如果字典特别大，用第一种。

坑2：setdefault和defaultdict，你该用哪个

这个场景极其常见：你要往字典里追加值，但不确定key存不存在。

新手写法：

defaultdict(list)的意思是：访问任何不存在的key时，自动创建一个空列表。不需要判断、不需要setdefault，直接append。

区别在哪？setdefault适合"偶尔需要默认值"的场景，defaultdict适合"几乎每个key都需要默认值"的场景。如果你只有10%的key需要默认值，用setdefault更明确；如果90%的key都需要，defaultdict省掉大量重复代码。

坑3：字典的|运算符，3.9之后才有

合并两个字典，你大概率写过这种：

这个语法在处理配置合并、默认值覆盖时特别清爽。但注意，如果你的项目需要兼容3.8及更早版本，不能用。

坑4：字典有序这件事，3.7才保证

面试常问：Python字典有序吗？

答案是：3.7开始，字典保证插入顺序。3.6是CPython实现细节，没写进语言规范。3.5及之前，字典无序。

这意味着什么？

但说实话，2026年了，大多数项目都跑在3.9+，普通字典就够了。OrderedDict存在的意义更多在于语义明确——看到OrderedDict你就知道这段代码依赖顺序，看到dict你不确定。

坑5：浅拷贝的陷阱

.copy()是浅拷贝。顶层key-value是独立的，但value如果是可变对象（列表、字典、集合），拷贝的只是引用。copied["tags"]和original["tags"]指向同一个列表，append操作两边都变了。

正确做法，用copy.deepcopy：

deepcopy会递归拷贝所有层级。代价是慢——如果字典嵌套很深或包含大量数据，deepcopy可能成为性能瓶颈。在性能敏感的场景，考虑用不可变数据结构（tuple替代list，frozendict替代dict），从根源避免这个问题。

坑6：in运算符只查key，不查value

坑7：get的默认值可以是任意对象，包括函数调用结果

try-except在key存在时没有额外开销，in检查需要多一次哈希查找。在性能敏感且key大概率存在的场景，try-except更快（EAFP原则：Easier to Ask Forgiveness than Permission）。

坑8：字典推导式的变量泄漏（3.7+已修复，但旧代码要注意）

Python 2里，列表推导式会泄漏循环变量到外层作用域。Python 3修复了这个问题，但字典推导式在某些早期3.x版本中仍有边缘情况。

这不是什么大坑，但如果你维护的是从Python 2迁移过来的老代码，注意检查推导式里的变量名是否和外层冲突。

坑9：JSON序列化时，字典的key必须是字符串

或者从源头避免：设计数据结构时，字典key就用字符串。

坑10：dict不是万能的，有时候你该用NamedTuple或dataclass

这个坑不是bug，是设计问题。

很多Python开发者的习惯是：需要存一组关联数据？字典走起。

dataclass的好处：拼写错误在运行时立即暴露，IDE能自动补全属性名，类型检查器（mypy、pyright）能在编译期发现问题。字典的灵活性是它的优点，也是它的缺点——太灵活了，错误只能在运行时发现。

判断标准很简单：如果你能在纸上写出这个字典的所有key，用它的人都知道key叫什么，那它就不是字典，是一个被字典伪装的对象。换成dataclass，代码健壮性立刻提升一个台阶。

字典是 Python 使用率最高的数据结构之一，但用得熟和用得对，隔着巨大的鸿沟。

以上10个坑，有的是直接炸程序的运行时bug，有的是拖垮服务的性能黑洞，还有的是日积月累、降低代码质量的可维护性隐患。

它们不会立刻让程序报错崩溃，却会在某个线上节点，给你突如其来的“惊喜”。

写代码最可怕的，从来不是“我不会”，而是我以为我全会了。

字典如此，编程的所有进阶细节，皆是如此。

学习笔记分享

更多资料获取方式：

1. 关注本公众号

2. 发送口令“Python”即可领取（人工回复可能存在轻微时差，大家无需着急，所有发送口令的同学都会收到资料）