KeyError是Python中因访问映射类型不存在键而引发的异常，解决核心是主动检查或提供默认行为：用in判断、get()设默认值、setdefault()初始化、try/except捕获，并注意JSON解析结果和自定义类的__getitem__方法。
KeyError 是 Python 中最常见的异常之一，表示你试图访问字典（dict）、defaultdict、json.loads() 解析后的对象等映射类型中**不存在的键**。解决它的核心思路是：不假设键一定存在，而是主动检查或提供默认行为。
检查键是否存在再访问
最直接安全的方式是用 in 判断键是否在字典里：
-
✅ 推荐写法：
if 'name' in user_dict:
print(user_dict['name'])
else:
print('name 未提供') -
❌ 避免写法：
print(user_dict['name']) # 如果 name 不存在，直接报 KeyError
用 get() 方法提供默认值
dict.get(key, default) 是处理缺失键最常用的方法，它不会抛异常，而是返回默认值（不传 default 时返回 None）：
-
age = user_dict.get('age', 0)→ 键不存在时返回0 -
city = user_dict.get('city', '未知城市')→ 更友好的默认提示 score = user_dict.get('score') # 返回 None，适合后续做 is None 判断
用 setdefault() 设置并获取默认值
当你想“如果键不存在，就插入一个默认值并返回它”，用 setdefault()：
立即学习“Python免费学习笔记（深入）”；
user_dict.setdefault('status', 'active') # 若无 status 键，则添加 'status': 'active'- 适合初始化字典结构，比如统计词频、分组聚合时预设空列表：
groups.setdefault('python', []).append('张三')
用 try/except 捕获并处理异常
当逻辑较复杂、或需区分不同缺失情况时，显式捕获更清晰：
try:
value = config['database']['host']
except KeyError as e:
print(f'配置缺失: {e}')
value = 'localhost'- 注意嵌套字典要逐层判断，或改用
get().get()链式调用（如config.get('database', {}).get('host', 'localhost')）
不复杂但容易忽略的是：JSON 解析后也是 dict，访问字段前同样要防 KeyError；另外，自定义类若实现了 __getitem__ 也可能抛这个错，排查时别只盯字典。
