Python遍历字典时怎么安全删除或修改元素

一、为什么遍历时直接删除会报错，而修改值却安全？

Python 字典在底层是基于哈希表实现的紧凑结构。为了防止在遍历过程中因底层数组扩容、重哈希或索引变动导致迭代器出现漏读、死循环或悬空指针，Python 在字典内部维护了一个变更计数器（mutation guard）。

当使用 for key in d 或 for k, v in d.items() 启动遍历时，解释器会创建一个字典视图迭代器，并记录当前的元素数量。在随后的每次循环步进中，迭代器都会校验当前字典的长度与版本状态。如果发现字典长度发生改变，便会立即触发运行时异常。

相较之下，直接更新已有键的数值（例如 d[key] = new_value）并不会增减键的条目，也不会改变字典长度或槽位排布。因此，迭代器在每轮循环检查长度时均能顺利通过校验。

二、遍历时安全修改元素值的标准做法

如果只是更新已有键对应的值，直接在循环中对字典通过键下标赋值即可。为了让代码更清晰，推荐使用 .items() 方式：

prices = {"apple": 10, "banana": 5, "cherry": 25}

# 安全：遍历键值对，仅更新已有键的值
for key, value in prices.items():
    if value < 10:
        prices[key] = value * 2

print(prices)
# 示例输出: {'apple': 10, 'banana': 10, 'cherry': 25}

三、遍历时安全删除元素的实操方案

要在遍历逻辑中剔除某些键值，必须避免“一边直接遍历字典视图，一边就地修改该字典结构”。根据具体业务诉求，推荐以下三种安全可靠的写法。

方法 1：遍历键的快照列表（就地修改原字典）

如果必须在原地（in-place）修改原字典对象（例如该字典已经被多处引用，不能更改内存地址），最直接的方法是使用 list(d.keys()) 或简写为 list(d) 提取所有键的静态快照。

user_scores = {"Alice": 95, "Bob": 58, "Charlie": 82, "David": 45}

# 安全：通过 list() 生成键的独立快照，在循环中就地删除原字典键
for user in list(user_scores.keys()):
    if user_scores[user] < 60:
        del user_scores[user]

print(user_scores)
# 示例输出: {'Alice': 95, 'Charlie': 82}

方法 2：字典推导式（推荐，构建全新字典）

如果不需要强行保持原字典的引用地址，字典推导式（Dictionary Comprehension）是最推荐、最符合 Pythonic 风格且运行效率最高的方法。它以声明式语法完成条件过滤，底层由 C 语言加速，没有额外的多次属性查找开销。

user_scores = {"Alice": 95, "Bob": 58, "Charlie": 82, "David": 45}

# 推荐：使用字典推导式保留满足条件的键值对，生成新字典
passed_scores = {k: v for k, v in user_scores.items() if v >= 60}

print(passed_scores)
# 示例输出: {'Alice': 95, 'Charlie': 82}

方法 3：两阶段处理（先收集待删除键，再统一执行）

当删除判断逻辑较为复杂（例如涉及外部 I/O 查询、网络校验或需记录详细的删除日志）时，推荐采用两阶段方案：第一阶段只遍历不修改，将符合删除条件的键收集到列表或集合中；第二阶段统一从原字典中剔除。

metrics = {"cpu": 85, "mem": 40, "disk": 92, "io": 15}

# 阶段 1：收集符合条件的键
keys_to_remove = [k for k, v in metrics.items() if v < 50]

# 阶段 2：统一安全移除
for k in keys_to_remove:
    metrics.pop(k, None)

print(metrics)
# 示例输出: {'cpu': 85, 'disk': 92}

四、方案选型与总结对比

不同方案在执行性能、内存占用以及引用保留方面存在明确差异。实际编写代码时可以按照以下依据进行选择：

• 常规过滤首选字典推导式：语法直观、逻辑清晰，避免原地反复变动哈希表。
• 必须原地修改时使用 list(d) 快照：确保遍历目标脱离动态视图，避免触碰迭代器长度保护机制。
• 更新键值随时直接进行：只要不触发键的新增与删除，d[k] = new_value 始终是安全的。