Python 常见异常类型与处理最佳实践

10次阅读

python 异常处理旨在保障程序可控运行,需精准捕获常见内置异常(如 valueerror、typeerror 等),遵循避免空捕获、提供有意义反馈、善用 else/finally 等原则,并推荐自定义异常与上下文管理提升健壮性。

Python 常见异常类型与处理最佳实践

Python 异常处理不是为了掩盖错误,而是让程序在意外发生时仍能可控地运行。掌握常见异常类型和合理使用 try-except,是写出健壮代码的关键一步。

最常遇到的内置异常类型

了解这些异常的触发场景,能帮你快速定位问题:

  • ValueError:传入参数类型正确但值不合适,比如 int("abc")math.sqrt(-1)
  • TypeError:操作或函数应用于不支持的对象类型,如 "hello" + 123 或调用不可调用对象 42()
  • KeyError:字典中访问不存在的键,如 d = {}; d["missing"]
  • IndexError:序列(列表、元组、字符串)索引越界,如 [1,2][5]
  • FileNotFoundError:尝试打开不存在的文件,open("nonexistent.txt")
  • ZeroDivisionError:除数为零,10 / 0
  • AttributeError:访问对象不存在的属性或方法,如 "abc".append(1)

异常处理的实用原则

避免空 except: 或宽泛捕获 Exception,优先精准捕获、明确处理逻辑:

  • 只捕获你预期且能处理的异常类型,例如读文件时捕获 FileNotFoundErrorPermissionError,而不是笼统的 Exception
  • except 块中提供有意义的反馈,比如记录日志、给出默认值或引导用户修正输入
  • else 子句执行无异常时的逻辑(如成功解析后写入数据库),避免把正常流程塞进 try
  • 必要时用 finally 确保清理动作执行,比如关闭文件、释放锁,无论是否出错

推荐的结构化写法示例

以安全读取 JSON 配置文件为例:

立即学习 Python 免费学习笔记(深入)”;

import json <p>def load_config(filepath): try: with open(filepath, "r", encoding="utf-8") as f: return json.load(f) except FileNotFoundError: print(f" 配置文件 {filepath} 未找到,使用默认配置 ") return {"debug": False, "timeout": 30} except json.JSONDecodeError as e: print(f" 配置文件格式错误:{e}") return {"debug": False, "timeout": 30} except PermissionError: print(f" 无权限读取 {filepath}") raise  # 权限问题通常不应静默忽略,选择重新抛出 

进阶建议:自定义异常与上下文管理

当业务逻辑有明确错误语义时,定义自己的异常类,提升可读性和可维护性:

  • 继承 Exception 或更具体的内置异常,例如 class InvalidUserInputError(ValueError): pass
  • 在关键函数或模块入口做参数校验,并主动 raise 自定义异常,比让下游处理模糊的 TypeError 更清晰
  • 结合 contextlib.suppress 忽略已知可忽略的异常(如删除临时文件时文件可能不存在),比写 try-except-pass 更简洁
  • 对资源操作,优先使用 with 语句(上下文管理器),它本质已封装了异常安全的清理逻辑

text=ZqhQzanResources