Python 字典合并用 | 还是 update?先看你是否需要保留原对象

举报
TechCao 发表于 2026/11/19 10:29:27 2026/11/19
【摘要】 Python 3.9 起支持字典并集,但 |、|= 和 update 的对象修改语义不同。本文用可运行示例说明覆盖顺序、原地修改和映射类型的适用边界。

Python 3.9 起,字典支持 | 合并。它看起来只是 update 的简写,但两者的核心差异不是语法长短,而是“是否创建新字典”。弄清这个区别,可以避免函数意外修改调用方传入的数据。

update 会改动左侧字典

defaults = {"timeout": 5, "retries": 2}
options = {"timeout": 10}

result = defaults.update(options)
print(result)    # None
print(defaults)  # {'timeout': 10, 'retries': 2}

dict.update() 是原地操作,返回值是 None。右侧键与左侧键冲突时,右侧值覆盖左侧值;右侧新增的键也会写入左侧对象。所以上面的 defaults 已经不是原来的默认配置。如果 defaults 还会被其他代码复用,这种隐式改动就可能变成难查的状态问题。

| 会产生一个新字典

defaults = {"timeout": 5, "retries": 2}
options = {"timeout": 10}

merged = defaults | options
print(merged)   # {'timeout': 10, 'retries': 2}
print(defaults) # {'timeout': 5, 'retries': 2}

字典并集保留两个输入,返回一个新字典,冲突时仍由右侧优先。因此,构造临时配置时常写成 merged = defaults | options。要叠加多层设置,可以按从低优先级到高优先级的顺序合并:

config = built_in | project_config | command_line

后出现的字典拥有更高优先级。这个顺序读起来也能直接表达“命令行参数覆盖项目配置,项目配置覆盖内置默认值”。

原地并集 |= 仍会修改左侧

不要把 |= 当成“安全版 |”:

settings = {"theme": "light"}
settings |= {"theme": "dark"}

|= 与 update 一样修改现有字典。它适合明确需要累积结果的场景;若调用方仍要使用旧值,就应使用 | 创建新对象。区分这两种需求比选哪个运算符更重要。

映射类型也有差别

update 接受字典、键值对序列或提供键值的对象;普通字典的 | 要求参与合并的一侧是字典。若右侧是列表形式的键值对,下面的写法可用:

result = {"timeout": 5}
result.update([("retries", 2)])

但 {"timeout": 5} | [("retries", 2)] 会抛出 TypeError。遇到 Mapping 抽象或自定义字典子类时,也应查看该类型是否实现了并集运算;不能仅因它能被 update 接受,就假设 | 一定适用。

选择时问自己一个问题

需要保留原字典并表达优先级合并,用 |;需要累积写入某个已有字典,用 update 或 |=。尤其在函数里,先想清楚参数对象归谁所有:若传入的配置属于调用者,通常不要在不说明的情况下原地覆盖它。这个小小的对象所有权约定,往往比把代码缩短一行更能减少问题。

最小验证

以下断言可以在本地运行,检查覆盖顺序、对象是否被修改,以及 update 的返回值:

base = {"timeout": 5, "retries": 2}
override = {"timeout": 10}
combined = base | override
assert combined == {"timeout": 10, "retries": 2}
assert base == {"timeout": 5, "retries": 2}

returned = base.update(override)
assert returned is None
assert base["timeout"] == 10

记住:| 创建新字典,|= 和 update 原地修改。需要哪一种,就让代码清楚地表达哪一种。

【版权声明】本文为华为云社区用户原创内容,未经允许不得转载,如需转载请自行联系原作者进行授权。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。