在 Python 编程中，我们经常会遇到查找类异常，这类异常统一继承自
LookupError 基类。它是 Python 内置异常体系中专门用于处理「找不到目标元素 / 键 / 索引」的异常父类，日常开发中高频遇到的 KeyError、IndexError 都属于它的子类。本文会用通俗易懂的语言，结合实战代码，详解
LookupError 的核心子类、触发场景、捕获方法，帮你彻底理清这类异常的逻辑。一、先认识 LookupError 基类
LookupError 是所有查找失败异常的父类，它本身不直接抛出，而是作为一个「抽象父类」，统一管理所有「找不到指定元素 / 键 / 索引」的异常。简单来说：只要是「找不到东西」引发的异常，都属于 LookupError 的子类。
它的继承关系（核心子类）：
plaintext
BaseException
└── Exception
└── LookupError
├── IndexError # 索引越界
├── KeyError # 键不存在
└── CodecRegistryError # 编码注册表错误（极少用）
日常开发中，我们99% 的场景只需要关注 IndexError 和 KeyError，这也是本文重点讲解的两个子类。
二、核心子类 1：IndexError（索引错误）
1. 什么是 IndexError
当你使用超出序列范围的索引访问列表、元组、字符串等有序序列时，Python 会抛出
IndexError，直白说就是：索引不存在，越界了。2. 常见触发场景
有序序列的索引从
0 开始计数，如果你访问的索引 ≥ 序列长度，就会报错。python
运行
# 1. 列表索引越界
num_list = [10, 20, 30]
print(num_list[3]) # 列表只有3个元素，最大索引是2，索引3不存在 → IndexError
# 2. 字符串索引越界
text = "Python"
print(text[10]) # 字符串长度6，最大索引5 → IndexError
# 3. 元组索引越界
num_tuple = (1, 2)
print(num_tuple[5]) # 元组长度2，最大索引1 → IndexError
3. 捕获 IndexError
使用
try-except 可以优雅捕获该异常，避免程序崩溃：python
运行
num_list = [10, 20, 30]
try:
print(num_list[3])
except IndexError:
print("错误：访问的列表索引超出范围！")
三、核心子类 2：KeyError（键错误）
1. 什么是 KeyError
当你使用不存在的键访问字典（dict）时，Python 会抛出
KeyError，也就是：字典中没有这个键。2. 常见触发场景
字典是「键值对」结构，只能访问已定义的键：
python
运行
# 字典访问不存在的键
student = {"name": "小明", "age": 18}
print(student["gender"]) # 字典中没有 gender 键 → KeyError
3. 捕获 KeyError
同样用
try-except 捕获，也可以用字典 get() 方法避免报错：python
运行
# 方法1：try-except 捕获
student = {"name": "小明", "age": 18}
try:
print(student["gender"])
except KeyError:
print("错误：字典中不存在该键！")
# 方法2：推荐用 get() 方法，键不存在时返回默认值（不报错）
print(student.get("gender", "未知")) # 输出：未知
四、冷门子类：CodecRegistryError（编码注册表错误）
这个子类日常开发几乎不会遇到，简单了解即可：
- 属于 Python 编码 / 解码模块的底层异常
- 当编码注册表中找不到指定的编码器 / 解码器时抛出
- 普通开发完全不用主动处理，了解它是
LookupError子类即可
五、统一捕获 LookupError
因为
IndexError 和 KeyError 都继承自 LookupError，所以我们可以用父类统一捕获所有查找类异常，适合简化代码：python
运行
data = [1, 2, 3]
info = {"a": 1}
try:
# 任意一个查找错误都会被捕获
print(data[10])
# print(info["b"])
except LookupError as e:
print(f"捕获到查找异常：{type(e).__name__}，详情：{e}")
运行后会输出：
plaintext
捕获到查找异常：IndexError，详情：list index out of range
六、LookupError 子类总结表
表格
| 异常类 | 触发场景 | 常见数据类型 | 重要程度 |
|---|---|---|---|
| IndexError | 索引超出序列范围 | 列表、元组、字符串 | ⭐⭐⭐⭐⭐ |
| KeyError | 访问字典不存在的键 | 字典 | ⭐⭐⭐⭐⭐ |
| CodecRegistryError | 找不到编码器 / 解码器 | 编码模块底层 | ⭐ |
七、开发建议
- 优先捕获具体子类：需要精准处理时，分别捕获
IndexError和KeyError - 简化代码用父类：统一处理查找错误时，直接捕获
LookupError - 提前预判避免报错：
- 列表 / 字符串：用
len()判断长度后再访问索引 - 字典：优先用
get()方法，或用in判断键是否存在
- 列表 / 字符串：用
总结
LookupError是 Python 所有查找失败异常的父类- 开发核心关注两个子类：
IndexError（索引越界）、KeyError（字典键不存在） - 可以用父类
LookupError统一捕获所有查找类异常，简化异常处理逻辑 - 养成预判习惯，能从源头避免这类异常，让代码更健壮
理清
LookupError 及其子类，能帮你快速定位「找不到元素」类的 bug，写出更稳定的 Python 代码。