Python 3.10 的字典合并操作符 | 是右优先、单向、浅拷贝的只读合并，等价于 {left, right}，不支持深度合并、原地更新（|= 行为类似 update）或冲突处理。
Python 3.10 确实支持用管道符 | 合并字典，但它不是“万能覆盖式”合并，而是单向、右优先的浅拷贝合并 —— 这一点不搞清，很容易踩坑。
字典合并操作符 | 的行为本质
它返回一个新字典，逻辑等价于：{**left, **right}，即左侧字典所有键值先写入，右侧字典同名键会覆盖，且不递归处理嵌套结构。
关键点：
-
|是只读操作，不会修改原字典 - 右侧字典的键值对完全“压”到左侧结果上，无深拷贝、无冲突回调、无类型检查
- 如果右侧是空字典（如
{}），结果就是左侧字典的浅拷贝 - 不支持
|=原地更新字典（那是 Python 3.9+ 的dict.update()语义，但|=在 3.10 中已支持，行为类似update）
什么时候该用 |，什么时候不该用
适合场景：配置覆盖、临时组合、函数参数拼接、默认值注入。
不适合场景：需要深度合并（比如嵌套 dict 合并）、需保留左侧不可变结构、或右侧含可变对象需独立副本。
常见误用现象：
- 以为
a | b | c能自动去重或智能合并列表类值 → 实际只是逐层覆盖，list类型直接被替换 - 把含
datetime或自定义对象的字典用|合并后，发现引用没断开，改右侧影响了结果 → 因为是浅拷贝 - 在循环中反复
acc = acc | new_dict，性能明显下降 → 每次都新建字典，O(n²) 时间复杂度
| 和 ** 解包、dict(**a, **b) 的差异
三者在多数简单场景结果一致，但细节不同：
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac
下载
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
-
a | b：要求a和b都是dict实例（或实现了__or__的子类），否则抛TypeError -
{**a, **b}：只要a、b可迭代且返回键值对（如dict_items、tuple列表），就能用；但若含非字符串键，可能报TypeError: keywords must be strings -
dict(**a, **b)：强制所有键转为字符串，且仅支持映射类型或关键字参数风格，适用面最窄
示例对比：
left = {'x': 1, 'y': [1, 2]}
right = {'y': [3, 4], 'z': 'ok'}
result = left | right # {'x': 1, 'y': [3, 4], 'z': 'ok'} —— y 被完整替换，不是 extend
嵌套字典合并必须手动处理
| 对嵌套字典完全无感。比如 left = {'conf': {'host': 'a'}} 和 right = {'conf': {'port': 8080}}，用 left | right 得到的是 {'conf': {'port': 8080}} —— 整个 'conf' 键被右侧覆盖，左侧的 'host' 消失了。
真要合并嵌套结构，得自己写递归或借助第三方，例如：
def deep_merge(a, b):
result = a.copy()
for k, v in b.items():
if k in result and isinstance(result[k], dict) and isinstance(v, dict):
result[k] = deep_merge(result[k], v)
else:
result[k] = v
return result
这种逻辑无法靠 | 简化，别试图“链式叠加”来绕过。
真正优雅的前提是清楚它的边界：它优雅在简洁和语义明确，不优雅在毫无妥协。一旦需求超出浅层覆盖，就得切换策略，而不是给 | 套上各种 wrapper。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
