Python 常见报错及解决方案梳理
在 Python 开发过程中，遇到报错是常态。掌握常见报错的含义及解决方法能极大提升调试效率。以下整理了高频异常及其处理策略，涵盖属性、文件、缩进、索引、类型等多个维度。
1. AttributeError：对象没有相关属性
描述：访问的对象不存在指定的属性或方法。 可能原因：
- Python 内置对象没有该属性。
- 自定义对象未设置该属性。
- 通过类名访问实例属性（应使用实例名）。
- 拼写错误。 解决方案：
- 检查属性名称拼写。
- 确认对象是否已正确初始化。
- 避免通过类名直接访问实例属性。
class Person:
def __init__(self):
self.name = "Alice"
p = Person()
print(p.age) # 会抛出 AttributeError
2. FileExistsError：文件已存在
描述：尝试创建已存在的文件或目录。 解决：先判断文件是否存在，若存在则跳过创建或使用覆盖模式。
import os
if not os.path.exists("test.txt"):
with open("test.txt", "w") as f:
f.write("Hello")
3. FileNotFoundError：文件或目录不存在
描述：请求的文件或目录路径无效。 解决：检查路径字符串是否正确，确保相对/绝对路径无误。
try:
with open("missing.txt", "r") as f:
pass
except FileNotFoundError:
print("文件未找到")
4. IndentationError：缩进错误
描述：代码块缩进不符合 Python 语法规范。 常见情况：
- 函数或类定义下无缩进。
- if/for/while 语句下结构体未缩进。
- 同一级代码块缩进不一致。
- 包含非法字符或不可见内容。 解决：统一使用 4 个空格缩进，删除多余空格，检查隐藏字符。
5. IndexError：列表或字符串索引越界
描述：访问的索引超出容器范围。 解决：
- 获取元素前判断索引是否在有效范围内。
- 使用 try-except 捕获异常。
lst = [1, 2, 3]
if len(lst) > 0:
print(lst[0])
else:
print("列表为空")
6. IsADirectoryError：操作目录而非文件
描述：试图对目录执行文件操作（如读取内容）。 解决：补充完整文件名，或确认操作对象为文件。
import os
if os.path.isfile("dir_name"):
with open("dir_name", "r") as f:
pass
7. TypeError：类型不匹配
描述：对不支持的操作数执行了操作。 常见情况：
- 字符串与非字符串类型拼接。
- 函数参数个数或类型不符。
- 元组元素赋值（元组不可变）。 解决：
- 使用 str() 转换类型后再连接。
- 检查函数调用参数。
- 将元组转换为列表修改。
# 错误
result = "Age: " + 25
# 正确
result = "Age: " + str(25)
8. KeyError：字典键不存在
描述：根据不存在的键获取字典值。 解决：
- 使用
dict.get(key)安全获取。 - 删除前先判断键是否存在。
data = {"name": "Bob"}
value = data.get("age") # 返回 None 而非报错
9. ModuleNotFoundError：模块未找到
描述：导入的模块不存在。 解决：
- 检查模块名称拼写。
- 使用 import 语句导入。
- 使用 pip 安装第三方模块。
pip install pymysql
10. NameError：变量未定义
描述：使用了未定义的局部或全局变量。 解决：
- 确保变量在使用前已定义。
- Python 3 中 xrange() 已移除，改用 range()。
11. RecursionError：递归深度超限
描述：递归调用层数超过系统限制。 解决：
- 禁止无限递归，增加终止条件。
- 必要时调整递归深度限制（谨慎使用）。
12. SyntaxError：语法错误
描述：代码不符合 Python 语法规则。 常见情况：
- 字符串引号未成对。
- 语句后忘记写冒号。
- 使用中文标点符号。
- 默认参数位置错误。 解决：检查括号、引号、冒号是否为英文半角，调整参数顺序。
13. TimeoutError：连接超时
描述：网络请求或数据库连接超时。 解决：
- 检查配置信息是否正确。
- 验证 URL 或数据库地址可达性。
- 增加超时时间设置。
14. ValueError：值错误
描述：传入的参数类型正确但值无效。 常见情况：
- 字符串无法转换为浮点数。
- int() 接受非数字字符串。
- 子字符串未找到。 解决：清洗输入数据，确保格式符合预期。
try:
float("12.2 月")
except ValueError:
print("格式错误")
15. ZeroDivisionError：除零错误
描述：0 作为除数。 解决：运算前判断除数是否为 0。
if divisor != 0:
result = numerator / divisor
16. 其他常见异常
ImportError
当模块无法导入时抛出。通常由路径错误或依赖缺失引起。确保模块已安装且路径正确。
MemoryError
内存不足。优化数据结构，减少大对象占用，或增加系统内存。
KeyboardInterrupt
用户中断程序（如 Ctrl+C）。可在 except 块中处理优雅退出逻辑。
17. 异常处理最佳实践
- 最小化 try 范围：仅包裹可能出错的代码段。
- 记录日志：使用 logging 模块记录异常堆栈，便于排查。
- 明确异常类型：避免使用裸 except，指定具体异常类。
- 资源清理：使用 finally 或 context manager (with) 确保资源释放。
try:
file = open("data.txt")
content = file.read()
except IOError as e:
print(f"IO 错误：{e}")
finally:
if 'file' in locals():
file.close()
总结
本文详细解析了 Python 核心异常的触发原因与修复方案。通过规范编码习惯、完善输入校验及使用 try-except 结构，可显著提升程序健壮性。建议开发者建立本地错误速查表，结合日志分析快速定位问题。
