Skip to content

KeyError:字典中找不到键

快速摘要

你用 dict[key] 访问了字典中不存在的键 —— Python 抛出 KeyError 并以缺失的键为参数。

为什么发生

  • 键从未插入字典,或在访问前被删除

  • 键的类型或值与存储的不匹配 —— 如字符串 '1' 与整数 1

  • 字典预期有默认条目但未在访问前初始化

最小示例

✗ 错误代码
config = {'host': 'localhost', 'port': 8080}
print(config['database'])  # KeyError: 'database'
✓ 修复代码
config = {'host': 'localhost', 'port': 8080}
print(config.get('database', 'default_db'))  # prints 'default_db'

使用带默认值的 dict.get() 在键缺失时返回默认值,完全避免 KeyError。

如何诊断

  • 打印 dict.keys() 与你尝试访问的键比较

  • 检查键的类型 type(key) —— Python 中字符串键和整数键是不同的

  • 用调试器或 print 语句追踪字典填充的位置和添加了哪些键

如何修复

  • 使用 dict.get(key, default) 在键缺失时返回默认值而非抛出 KeyError

  • 使用 collections.defaultdict 为缺失键自动创建默认值条目

  • 访问前用 'key in dict' 检查成员资格,键不存在时插入默认值

如何预防

  • 对所有可能不存在的键访问使用带默认值的 dict.get()

  • 使用前用所有预期键和默认值初始化字典

相关资源

相关术语

相关课程

← 返回语言