遍历字典时删键会报 RuntimeError，因为 Python 通过检查字典的 ma_version_tag 版本号检测结构变更，修改触发保护机制以防止迭代器访问非法内存。

为什么遍历字典时删键会报 RuntimeError？

Python 在迭代 dict 时会检查内部哈希表的版本号（ma_version_tag），一旦在循环中调用 del d[key] 或 d.pop(key)，字典结构被修改，版本号变更，解释器立刻抛出 RuntimeError: dictionary changed size during iteration。这不是 bug，而是明确的设计保护——避免迭代器指向已释放或重排的内存位置。

这种错误常见于清洗数据、去重、条件过滤等场景，比如：

user_scores = {'alice': 85, 'bob': 92, 'carol': 47, 'dave': 61}
for name, score in user_scores.items():
    if score < 60:
        del user_scores[name]  # ❌ 触发 RuntimeError

安全删除字典元素的三种实操方式

• 直接构造新字典：最推荐，语义清晰、线程安全、无副作用
  {k: v for k, v in user_scores.items() if v >= 60}

• 先收集待删 key，再批量删除：适合需复用原字典对象引用的场景（如函数传入的是可变参数）

  立即学习“Python免费学习笔记（深入）”；

  

  Forge — Python Developer

  Python开发助手 — 自动化脚本、API封装、命令行工具、数据管道、网页爬虫。经过测试的代码，包含错误处理和文档。当你需要...

  下载

  to_remove = [k for k, v in user_scores.items() if v < 60]
  for k in to_remove:
    del user_scores[k]

• 使用 list(d.keys()) 创建快照迭代：兼容旧代码改造，但注意内存开销（key 多时生成新列表）

  for k in list(user_scores.keys()):
    if user_scores[k] < 60:
        del user_scores[k]

不要用 d.copy().items() 迭代后删原字典——看似绕过检查，但逻辑上仍是“边读边改”，且 copy 开销更大。

用 popitem() 和 dict comprehension 的边界情况

popitem() 默认从末尾弹出，不依赖 key，所以可以在 while 循环中安全使用：

while user_scores:
    name, score = user_scores.popitem()
    if score < 60:
        continue  # 丢弃低分项
    else:
        # 处理高分项，但注意：此时 user_scores 已被破坏，无法恢复原始顺序

而 dict comprehension 虽简洁，但要注意：

• 它返回全新字典，原对象引用失效（id(old) != id(new)）
• 若字典值是可变对象（如嵌套 dict/list），新字典里仍共享引用，不是深拷贝
• Python {k:v for ...} 的 key 顺序可能与原字典不同

容易被忽略的隐式修改陷阱

• dict.update() 或 ** 解包赋值本身不触发该错误，但若在迭代过程中调用它们，仍属“运行时修改”，同样会报错
• 使用 defaultdict 或自定义 <strong>missing</strong> 的字典，只要在 for k in d: 中触发了 key 插入（比如访问不存在的 key 导致自动创建），也会触发该 RuntimeError
• 多线程环境下，即使你没显式删 key，其他线程修改字典也会导致当前迭代崩溃——这时需要加锁，而不是换遍历写法

真正要警惕的，从来不是“怎么删”，而是“删的时候有没有人正在看”。