遍历字典时删键会报 runtimeerror，因哈希表结构变化导致迭代器失效；安全做法是用 list(d.keys()) 固化键列表再删，或用字典推导式重建。
为什么遍历字典时删键会报 RuntimeError
Python 在迭代 dict 时，底层用的是哈希表的迭代器，它依赖字典当前的结构（比如桶数量、键值对分布）。一旦你在循环中调用 del d[key] 或 d.pop(key)，字典实际大小（len(d)）变了，哈希表可能触发重散列或内部指针失效——这时解释器直接抛 RuntimeError: dictionary changed size during iteration，不给你机会“侥幸成功”。
这不是 bug，是明确的设计保护：避免迭代结果不可预测。
用 list(d.keys()) 安全删除匹配项
最常用也最直观的解法：把要遍历的键提前固化成一个 list，后续删操作只影响原字典，不影响正在遍历的列表。
Claw Code Suite (Python-Only Edition)
下载
仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...
- 适用于「根据键名条件批量删除」，比如清理所有以
"temp_"开头的键 -
list(d.keys())是浅拷贝，不复制值，开销小；但注意它只拷贝当前键的引用，不冻结字典结构本身 - 别写成
[k for k in d]—— 这仍是动态迭代，照样报错
data = {"name": "alice", "temp_x": 123, "age": 30, "temp_y": 456}
for key in list(data.keys()):
if key.startswith("temp_"):
del data[key]
# ✅ 成功后 data == {"name": "alice", "age": 30}
用 dict.copy() 或 dict.keys() 浅拷贝的区别
d.copy() 和 list(d.keys()) 都能避开报错，但语义和适用场景不同：
-
list(d.keys())：只关心「哪些键要检查」，适合基于键名过滤删除 -
d.copy()：得到一个键值对快照，适合需要读取值做判断再删原字典的情况，例如：if snapshot[k] - 两者都是浅拷贝——如果字典值是可变对象（如嵌套 dict），修改副本里的值仍会影响原字典的对应值；但删除操作本身不涉及值的深浅，所以不影响安全性
更高效的做法：重建字典而非边遍历边删
当删除逻辑较复杂，或待删键比例较高（比如 >30%），直接构造新字典往往更快、更清晰，也彻底规避迭代风险。
- 用字典推导式：
d = {k: v for k, v in d.items() if not k.startswith("temp_")} - 如果需保留插入顺序（Python 3.7+ 默认保证），新字典顺序与原字典一致
- 注意：这会丢弃原字典对象的内存地址，若其他变量引用了该字典，它们不会自动更新（即不是就地修改）
真正容易被忽略的是引用问题：你以为在“清理”一个全局配置字典，结果用了 d = {...} 赋值，外部拿到的还是旧对象。这时候得用 d.clear(); d.update({...}) 才算就地更新。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
