如何在Python中更新嵌套字典的指定值

这种问题通常是因为直接替换了上层字典对象或者多个键引用了同一个子字典实例导致的，下面我会结合常见场景给出解决方案：

一、先搞懂你为什么会"全更新" #

先看两个典型的错误案例，对应你遇到的问题：

案例1：直接替换上层子字典 #

假设你的原始字典是这样：

original = {
    "user": {
        "profile": {"name": "Alice", "age": 25},
        "settings": {"theme": "light"}
    }
}

如果你想更新profile里的age，但错误地写了：

update_data = {"user": {"profile": {"age": 26}}}
original.update(update_data)

这时候user下的settings会直接消失！因为update方法会把original["user"]整个替换成新的字典，而不是合并嵌套内容。

案例2：子字典引用重复 #

如果你的字典是这样创建的：

default_info = {"score": 0}
student_scores = {
    "Tom": default_info,
    "Jerry": default_info
}
student_scores["Tom"]["score"] = 90

这时候Jerry的score也会变成90，因为Tom和Jerry指向的是同一个字典对象，修改一个就会联动所有引用。

二、正确的解决方案 #

根据你的需求场景，选对应的方法：

1. 直接更新单个特定值（已知键路径） #

如果你明确知道要更新的嵌套键路径，直接链式访问赋值就好，这是最简单的方式：

# 只更新profile下的age
original["user"]["profile"]["age"] = 26

如果担心路径不存在会报错（比如profile可能没创建），可以用setdefault逐层确保键存在：

# 确保user -> profile存在，再赋值age
original.setdefault("user", {}).setdefault("profile", {})["age"] = 26

2. 递归合并更新（有多个嵌套键需要更新） #

如果你有一个包含部分嵌套内容的更新字典，想要合并而非替换，可以写一个递归更新函数：

def recursive_nested_update(original_dict, update_dict):
    for key, val in update_dict.items():
        # 如果当前值是字典，且原字典中对应键也是字典，就递归更新
        if isinstance(val, dict) and key in original_dict and isinstance(original_dict[key], dict):
            recursive_nested_update(original_dict[key], val)
        # 否则直接赋值（覆盖或新增）
        else:
            original_dict[key] = val

使用示例：

update_data = {"user": {"profile": {"age": 26, "city": "New York"}}}
recursive_nested_update(original, update_data)
# 此时original的结构是：
# {
#     "user": {
#         "profile": {"name": "Alice", "age": 26, "city": "New York"},
#         "settings": {"theme": "light"}
#     }
# }
# 既更新了age，新增了city，还保留了原来的settings

3. 解决子字典引用重复的问题 #

如果是因为多个键引用同一个子字典导致的联动修改，需要为每个键创建独立的子字典实例，用copy.deepcopy深拷贝：

import copy

default_info = {"score": 0}
student_scores = {
    "Tom": copy.deepcopy(default_info),
    "Jerry": copy.deepcopy(default_info)
}
student_scores["Tom"]["score"] = 90
# 此时Jerry的score还是0，互不影响

内容的提问来源于stack exchange，提问作者Sudhanshu Bhandarwar