一、基础知识

异常是程序运行中出现的非正常情况,比如除以零、文件不存在、网络断开。Python 用 try 块包裹"可能出错的代码",一旦出错就跳到对应的 except 块处理,程序不至于直接崩溃。

完整的异常结构有四个子句,各自职责不同:

  • try:放可能出错的代码,且只放这些代码。放得越少,越容易定位问题。
  • except:捕获并处理指定类型的异常。可以有多个,按从具体到宽泛排列。
  • else:try 中"没有发生任何异常"时才执行。把"成功之后要做的事"放这里,能避免它被 except 误捕获。
  • finally:无论是否发生异常都执行,通常用来释放资源,比如关闭文件、断开连接。

先看一个最小例子:

try:
    x = 1 / 0
except ZeroDivisionError as e:
    print("除数不能为零:", e)

1 / 0 抛出 ZeroDivisionError,被 except 接住,打印提示后程序继续往下走,而不是终止。

Python 内置了很多异常类型,常见的有:ValueError(传入值类型对但内容不对)、TypeError(操作或函数用在了错误类型上)、KeyError(字典里没有这个键)、IndexError(下标越界)、FileNotFoundError(文件找不到)。实际写代码时,先想清楚"这段代码最可能抛哪种异常",再有针对性地捕获,而不是上来就写一个大范围的 except Exception。捕获得越准确,代码越能说明你的意图,也越不会误伤真正的问题。

为什么需要 else?看这个对比。如果把"成功后的解析"也放进 try:

try:
    data = int("abc")          # 这里会抛 ValueError
    print("结果是", data + 1)   # 这行也会被波及
except ValueError:
    print("输入不是数字")

int("abc") 失败后,print 那行根本不会执行,这没问题。但假设 print 里自己也抛了 ValueError,它会被同一个 except 吞掉,让你误以为是输入的问题。用 else 把成功逻辑隔开就不会:

try:
    data = int("123")
except ValueError:
    print("输入不是数字")
else:
    print("结果是", data + 1)

else 里的代码不在 try 的保护范围内,它自己抛出的异常不会被上面的 except 捕获,这正是我们想要的隔离效果。

二、实操步骤

下面做一个完整的"读取配置文件并解析"的例子,把四个子句都用上。保存为 demo_exception.py 运行。

第 1 步:只让 try 包住真正会出错的部分

import json

def load_config(path):
    try:
        with open(path, "r", encoding="utf-8") as f:
            text = f.read()
    except FileNotFoundError:
        print(f"文件不存在:{path}")
        return {}

这里 try 只包住"打开文件并读取",不包住后面的解析逻辑。

第 2 步:增加解析阶段的异常处理

import json

def load_config(path):
    try:
        with open(path, "r", encoding="utf-8") as f:
            text = f.read()
    except FileNotFoundError:
        print(f"文件不存在:{path}")
        return {}
    except UnicodeDecodeError:
        print("文件编码不是 UTF-8")
        return {}

    try:
        return json.loads(text)
    except json.JSONDecodeError:
        print("配置文件不是合法 JSON")
        return {}

注意两个 try 分开写:读取的异常和解析的异常互不干扰,定位更清楚。

第 3 步:用 else 放成功后的动作

import json

def load_config(path):
    try:
        with open(path, "r", encoding="utf-8") as f:
            text = f.read()
        config = json.loads(text)
    except (FileNotFoundError, json.JSONDecodeError) as e:
        print(f"加载失败:{e}")
        return {}
    else:
        print("配置加载成功,共", len(config), "项")
        return config

else 里的代码只在上面全部成功时运行,且不会捕获它自己抛出的异常。

第 4 步:用 finally 做收尾

import json

def load_config(path):
    handle = None
    try:
        handle = open(path, "r", encoding="utf-8")
        text = handle.read()
        config = json.loads(text)
    except (FileNotFoundError, json.JSONDecodeError) as e:
        print(f"加载失败:{e}")
        return {}
    else:
        print("配置加载成功")
        return config
    finally:
        if handle is not None:
            handle.close()
            print("已关闭文件句柄")

无论成功失败,finally 都会打印"已关闭文件句柄"。实际项目中更推荐 with open(...),它由上下文管理器自动关闭,更简洁不易漏。

三、关键细节

  1. finally 里的 return 会覆盖 try/except 的返回值:如果 finally 中写 return,它会"吞掉"前面所有的返回值和异常,这是极难排查的坑。切记 finally 只做清理,不写 return。
  2. 多个 except 按顺序匹配,子类放前面:ZeroDivisionError 是 ArithmeticError 的子类,若先写 except ArithmeticError,后面的 ZeroDivisionError 永远匹配不到。
  3. 不要写裸 except::它会连 KeyboardInterrupt(Ctrl+C)都捕获,导致程序无法用键盘中断。至少写成 except Exception:。
  4. 别用 except ...: pass 静默吞错:出问题后没有任何线索。至少打印或记录日志。
  5. raise 单独使用可重新抛出当前异常:在 except 里做一些处理后想让上层继续处理,写 raise 即可保留原始 traceback。
  6. else 和 finally 都不是必须的:只有确实有"成功后才做"或"无论如何都要清理"的需求时才加,别为凑结构而写。

四、常见错误

现象 原因 修正
用 Ctrl+C 无法终止程序 写了裸 except:,把 KeyboardInterrupt 也捕获了 改为 except Exception: 或捕获更具体的类型
finally 里写了 return,结果函数总返回那个值 finally 的 return 覆盖了 try 的返回值和异常 把 return 移到 try/else,finally 只做清理
自定义的 ZeroDivisionError 处理分支永远不执行 前面写了更宽泛的 except ArithmeticError 把具体异常写在宽泛异常之前
程序出错却没有任何提示 用了 except Exception: pass 吞掉异常 至少 print(e) 或用 logging 记录
想记录原始错误位置,重新抛出后 traceback 只剩新位置 在 except 里写了 raise ValueError(...) 没保留原异常 用 raise ... from e 或先 logging.exception() 再 raise
else 块里的异常没被 except 捕获,程序崩了 误以为 else 也在保护范围内 else 本就不受保护,需要捕获就再套一个 try

五、排查方法

  1. 先去掉所有 except,让异常直接抛出来,看真实的 traceback 指向哪一行。
  2. 运行 python -X dev demo_exception.py,开发模式会给出更多警告。
  3. 用 python -m pdb demo_exception.py 单步执行,n 下一步、c 继续,观察在哪一步跳转。
  4. 在关键 except 里临时加 import traceback; traceback.print_exc(),确认捕获的到底是什么异常。
  5. 逐块注释 finally,确认清理代码本身没有抛异常或改写返回值。
  6. 检查 except 顺序:把具体类型放到最前面再测一次。

六、注意事项

  • 异常处理的目的是"在能处理的地方处理"。如果本层无法真正恢复,就记录后 raise 交给上层,不要为了"看起来没报错"而吞掉。
  • with 语句(上下文管理器)能自动完成打开/关闭,比手写 finally 更不易出错,处理文件、锁、数据库连接时优先考虑。
  • 捕获 Exception 会漏掉 SystemExit、KeyboardInterrupt 等继承自 BaseException 的异常,这是刻意设计,避免误拦截控制流。
  • 异常链 raise X from Y 的写法在不同 Python 版本中均可用,但具体显示格式可能有差异,细节以官方文档为准。
  • 不要在循环里用异常做正常流程控制(比如靠捕获 StopIteration 退出),异常机制开销较大,逻辑也更难读。

免责声明:本文为个人学习与实操经验总结,仅代表个人观点,不构成任何技术或商业决策建议。不同系统环境与版本可能存在差异,实际操作请以官方文档为准并自行验证。