Skip to content

第 16 章:异常与调试 ​

本章承接第 15 章留下的尾巴——文件不存在时程序直接报错中断;把"出错"这件事讲透。用到的全是旧知识:函数(第 7、8 章)、条件(第 5 章)、文件读写(第 15 章)。

本章能学到什么 ​

  • bug 的三种类型:语法错误、运行错误、逻辑错误
  • 用 try / except / raise 让程序"接住"错误,而不是直接崩溃
  • 三种调试方法:打印调试法、逐行读代码、IDE 断点
  • 怎么看懂 Traceback 报错信息

场景:崩溃,还是"接住" ​

玩游戏时最怕两件事:一种是程序直接消失,一下午的进度没了;另一种是弹出一个提示:"存档损坏,已读取最近的备份",游戏继续。

两种结果的区别不在运气,在代码。程序员提前想到了可能出错的地方,写好了"接住"错误的代码,程序就能活下去。这种机制叫异常处理;找出错误在哪的过程,叫调试。本章前半章学"接住",后半章学"找"。

学校里也有同样的事:考试时发现题目印错了,一种做法是直接交白卷(崩溃),另一种是举手问老师、按老师的交代继续写(接住错误)。异常机制就是给程序一个"举手"的机会。

bug 的三种类型 ​

bug(程序错误)分三种,发生时机不同,对付办法也不同:

类型什么时候出现例子谁告诉你
语法错误运行前就发现少写冒号、缩进不齐、括号不配对解释器报 SyntaxError
运行错误程序运行时除以零、文件不存在、列表越界抛出异常,程序中断或接住
逻辑错误程序正常运行算平均分忘了除以人数没人告诉你,结果不对

语法错误最容易对付——解释器会指出在第几行。运行错误要靠异常机制接住,这是本章的主角。逻辑错误最隐蔽——程序不报错,只是答案错了,像数学考试里抄对了公式却算错了数,要靠调试方法找出来。

三种错误出现的顺序也有规律:学语言的头几周,几乎都是语法错误;开始写真正的程序后,运行错误多起来;语法越熟练,逻辑错误占的比例越高。错误类型的变化,本身就是进步的痕迹。

try / except / raise:接住错误 ​

异常机制三个角色:

角色关键字干什么
抛raise发现错误,把问题"扔出去"
试try圈出可能出错的代码
接except接住扔出来的问题,做善后
python
def divide(a, b):
    if b == 0:
        raise ValueError("divisor is zero")  # 发现除数是零,抛出去
    return a // b   # 整数除法

try:
    print(divide(10, 2))   # 正常,打印 5
    print(divide(10, 0))   # 抛出异常,流程直接跳到 except
    print("这行不会执行")
except ValueError as e:    # 接住 ValueError 类型的异常
    print("caught:", e)

print("program continues")
text
5
caught: divisor is zero
program continues

注意三件事:

现象说明
raise 之后的代码不再执行,流程直接跳到匹配的 except
except 按类型匹配raise 的是 ValueError,就由 except ValueError 来接
接完之后程序继续往下走,不会崩溃

如果没有 try/except,raise 出来的异常没人接,程序就中断并打印一串 Traceback。异常机制的价值在于:发现错误的代码(divide 函数深处)和处理错误的代码(外层的 except)可以分开写——写函数的人只管抛,用函数的人决定怎么善后。

一个 try 后面可以跟好几个 except,按类型分工;也可以把几种类型写在同一个括号里:

python
try:
    n = int("abc")
except ValueError as e:
    print("value error:", e)     # 先匹配具体的类型
except Exception as e:
    print("other error:", e)     # Exception 是大多数异常的"家长",兜底

还有一个可选角色 finally:不管出没出错都会执行的块,适合放"无论如何都要做"的收尾工作:

python
def divide(a, b):
    if b == 0:
        raise ValueError("divisor is zero")
    return a // b

try:
    print(divide(10, 0))
except ValueError as e:
    print("caught:", e)
finally:
    print("无论成败,这行都会执行")
text
caught: divisor is zero
无论成败,这行都会执行

常见异常类型速查 ​

Python 自带的异常是一个大家族,本章见过和即将常见的有:

异常类型什么时候抛
ValueError值不对劲,比如 int("abc")
ZeroDivisionError除以零
FileNotFoundError文件不存在
IndexError列表下标越界
KeyError字典里没这个键
TypeError类型不配合,比如 "1" + 2

这些异常都是 Exception 家族的成员。附录里有一张更全的对照表,写着每种报错的含义和改法。

什么时候自己 raise ​

自己写的函数也可以主动抛异常。发现参数不合理时,raise 比"假装没事、返回一个奇怪的结果"好得多——错误当场暴露,不会被带到很远的地方才爆发:

python
def set_age(age):
    if age < 0:
        raise ValueError("age cannot be negative")  # 年龄不能是负数
    print("age set to", age)

try:
    set_age(8)      # 正常
    set_age(-1)     # 抛异常,跳到 except
except ValueError as e:
    print("caught:", e)
text
age set to 8
caught: age cannot be negative

写函数的人负责报告错误,用函数的人负责决定怎么办——这正是分工。

finally 最常见的用途是收尾:不管中间成没成功,都要做的事——比如告诉用户"本次运行结束"、把临时数据清理掉。它和第 15 章的 with 是分工关系:开关文件交给 with,其余的收尾交给 finally。

【跨语言对照】try/except 与 try/catch ​

本质问题:错误发生时,正常的执行流程被打断,控制权交给谁、怎么交。

各自做法:

动作PythonC++
抛出异常raise ValueError("...")throw runtime_error("...")
圈出风险代码try:try { ... }
接住异常except ValueError as e:catch (const runtime_error& e)
异常是什么必须是 Exception 家族的成员可以是几乎任何类型的值

同一件事的两段代码,输出完全一致。Python 版就是上面 divide 的例子;C++ 版(详见《C++ 从入门到精通》第 16 章):

cpp
#include <iostream>
#include <stdexcept>    // runtime_error 的头文件
using namespace std;

int divide(int a, int b) {
    if (b == 0) {
        throw runtime_error("divisor is zero");  // 发现除数是零,抛出去
    }
    return a / b;   // 整数除法
}

int main() {
    try {
        cout << divide(10, 2) << endl;   // 正常,打印 5
        cout << divide(10, 0) << endl;   // 抛出异常,流程直接跳到 catch
        cout << "这行不会执行" << endl;
    } catch (const runtime_error& e) {   // 接住 runtime_error 类型的异常
        cout << "caught: " << e.what() << endl;
    }
    cout << "program continues" << endl;
    return 0;
}
text
5
caught: divisor is zero
program continues

再看第 15 章留下的问题——文件不存在。两种语言的处理方式恰好展示了设计差异:

python
# Python:打开失败直接抛出 FileNotFoundError
try:
    with open("not_exist.txt", "r", encoding="utf-8") as f:
        print(f.readline())
except FileNotFoundError:
    print("file not found, use default")

print("program continues")
cpp
// C++:打开失败默认不抛异常,要自己检查
ifstream fin("not_exist.txt");
if (!fin.is_open()) {
    cout << "file not found, use default" << endl;
} else {
    string line;
    getline(fin, line);
    cout << line << endl;
    fin.close();
}
cout << "program continues" << endl;

两段代码的输出都是:

text
file not found, use default
program continues

为什么设计不一样:Python 把常见错误统一做成了异常——文件打不开、除以零、下标越界,全部自动抛出,程序员只管接。C++ 把异常当成一种可选工具——文件打不开被当作一种普通状态,返回失败标志,要不要用异常由程序员决定。一个给统一,一个给选择,各自服务于自己的语言风格,没有高下之分。

异常会一路向外传 ​

异常抛出后,如果当前函数不接,就传给调用它的函数,一层一层向外找最近的 except:

python
def inner():
    raise ValueError("something broke")   # 最深处出错

def middle():
    inner()          # 自己不接,异常继续向外传

try:
    middle()         # 异常穿过 middle,在这里被接住
except ValueError as e:
    print("caught in main:", e)
text
caught in main: something broke

middle 里没有任何异常处理的代码,异常照样穿过了它。如果传到最外面还是没人接,程序才中断——没人接的异常最后变成的那段 Traceback,记录的正是这条"上报路线",每一层调用各占一行。这就是"写函数的人只管抛,用函数的人决定怎么善后"的完整含义。

调试:找出那只 bug ​

异常能接住"程序自己知道"的错误,逻辑错误要靠人找。三种常用方法:

方法做法适合什么场合
打印调试法在关键位置加 print,把变量的值打出来看不知道哪一步开始错的
逐行读代码从头读代码,把自己当成计算机,一行行在纸上算逻辑错误,程序不长
IDE 断点在 IDE 里设断点,程序跑到那里停下,逐个看变量程序长、变量多

打印调试法最快上手。算平均分结果不对,就在每一步后面打印:

python
total = 95 + 88 + 92
print("total =", total)     # 检查点 1
count = "3"                 # 从 input() 来的字符串,忘了转换!
avg = total / count         # TypeError:整数不能除以字符串

一运行就暴露了:count 是字符串。这正是第 3 章输入输出讲过的坑——input() 拿到的永远是字符串,要用 int() 转换。

逐行读代码有个绰号叫"小黄鸭调试法":把代码一行一行讲给桌上的小黄鸭听(讲给同学也行),讲着讲着,常常自己就发现了漏洞。道理是:看代码时脑子会偷懒,照着设想走;讲出来才被迫一行一行对着现实走。

IDE 断点是同一个思路的加强版:不用加打印语句,设一个断点,程序跑到那里就暂停,所有变量的值都能直接看,还能一步一步往下走。Thonny 的"调试"按钮、PyCharm 行号旁的红点都是它。

怎么看报错信息 ​

Python 的报错叫 Traceback(调用轨迹),看着吓人,其实有规律:从最后一行往前读。

text
Traceback (most recent call last):
  File "main.py", line 8, in <module>
    print(divide(10, 0))
  File "main.py", line 3, in divide
    raise ValueError("divisor is zero")
ValueError: divisor is zero
从哪读读到什么
最后一行错误类型和原因:ValueError: divisor is zero
倒数第二行出错的代码:raise ValueError(...)
再往上是谁调用了它:第 8 行调用了 divide

先看最后一行知道"是什么错",再往上看"在哪一行、谁调用的"。错误类型本身就是线索:NameError 是名字没定义,TypeError 是类型不配合,IndexError 是下标越界。附录里有一张常见报错对照表,可以当字典查。

常见坑 ​

坑现象办法
裸 except:什么错误都接住,连拼写错误也被吞掉写明要接的类型,如 except ValueError
except 顺序颠倒先写 Exception 兜底,后面的具体类型永远轮不到具体的类型写前面,兜底写最后
try 块太大不知道是哪一行抛的只圈可能出错的几行
接住后什么也不做问题被悄悄藏起,后面错得更离谱except 里至少打印一条信息

小结 ​

错误分三种:语法错误解释器拦,运行错误异常接,逻辑错误靠人找。raise 负责报告,try/except 负责善后,finally 负责收尾;打印、逐行读、断点负责把藏起来的逻辑错误揪出来。Traceback 不是天书——从最后一行往前读,先知道"是什么错",再找"在哪一行"。会看报错的人,调试就成功了一半。

动手实验 ​

  1. 故意制造三种 bug 各一个:if 后面漏冒号、divide(10, 0) 不接异常、平均分里拿字符串当数字。分别观察解释器的反应。
  2. 给第 15 章的成绩表程序加保护:读文件时如果某一行切不出三段、或某段不是数字,用 try/except 接住,跳过那一行继续读。
  3. 用 except 同时接多种异常:except (ValueError, ZeroDivisionError) as e:。写代码验证 int("abc") 和 1 // 0 都能被这一个 except 接住。
💡 查看答案

第 1 题:漏冒号报 SyntaxError: invalid syntax,程序一行都不会执行;divide(10, 0) 不接异常时程序中断,打印 Traceback 并以 ValueError: divisor is zero 结尾;字符串当数字时报 TypeError。三种错误,三种暴露方式。

💡 查看答案

第 2 题:

python
# 先造一份带坏行的成绩表
with open("scores.csv", "w", encoding="utf-8") as f:
    f.write("name,math,chinese\n")
    f.write("xiaoming,95,88\n")
    f.write("xiaogang,ninety,80\n")   # 坏行:成绩不是数字
    f.write("xiaohong,87,91\n")

with open("scores.csv", "r", encoding="utf-8") as f:
    f.readline()       # 表头
    for line in f:
        parts = line.strip().split(",")
        if len(parts) != 3:
            print("bad line skipped:", line.strip())
            continue
        name, math, chinese = parts
        try:
            total = int(math) + int(chinese)
            print(name, total)
        except ValueError:
            # 某个格子不是数字
            print("bad line skipped:", line.strip())
text
xiaoming 183
bad line skipped: xiaogang,ninety,80
xiaohong 178
💡 查看答案

第 3 题:

python
for text in ["abc", "0"]:
    try:
        n = int(text)          # "abc" 会抛 ValueError
        print(10 // n)         # n 为 0 时抛 ZeroDivisionError
    except (ValueError, ZeroDivisionError) as e:
        print("caught:", e)
text
caught: invalid literal for int() with base 10: 'abc'
caught: integer division or modulo by zero

两种异常类型写在括号里组成元组,一个 except 就能同时接住。