第 42 课：调试工具（pdb, IDE调试）

学习目标

完成本课学习后，你将能够：

理解程序调试的重要性，并能清晰地描述什么是"Bug"和"调试"。
掌握使用Python内置调试器pdb的基本命令，对程序进行交互式调试。
学会利用现代IDE（如VS Code）的图形化调试功能，高效地定位和解决问题。
根据不同场景，选择合适的调试策略（命令行 vs 图形化）。

核心概念

1. 调试是什么？

程序无法按预期运行，就是出现了"Bug"。而"调试"就是找到并修复这些Bug的过程。最简单的方法是使用print()语句输出中间变量，但当程序复杂时，这就像大海捞针，效率低下。

专业的调试工具允许你像"暂停"电影一样暂停程序，然后一步一步地执行代码，同时观察每个变量的值，清晰地看到程序的"思维"过程。

2. pdb：Python的内置调试器

pdb是Python自带的、基于命令行的调试工具。你不需要安装任何东西。它的核心思想是设置断点，让程序运行到特定位置时暂停，然后你就可以检查状态、单步执行。

3. IDE调试器：图形化的强大体验

现代集成开发环境（IDE）如VS Code、PyCharm，都内置了功能强大的图形化调试器。它们将pdb的功能封装成了按钮和面板，让你通过点击鼠标就能完成"单步跳过"、"单步进入"、"查看变量"等操作，极大地提升了调试效率和体验。

代码示例

示例1：使用pdb进行命令行调试

假设我们有一个计算平均数的函数，但在某种情况下会出错。我们来用pdb找出问题。

# 文件名：debug_example.py
def calculate_average(numbers):
    """计算数字列表的平均数，但没有处理空列表的情况"""
    total = sum(numbers)
    # 这里有Bug！如果numbers为空，会引发ZeroDivisionError
    average = total / len(numbers)
    return average

# 测试用例
test_data = [10, 20, 30]
empty_data = []

print(f"正常数据平均值: {calculate_average(test_data)}")

# 下面这行会触发错误
print(f"空列表平均值: {calculate_average(empty_data)}")

调试步骤（在命令行中）：

在命令行中运行脚本并进入pdb：
```
python -m pdb debug_example.py
```
你会进入(Pdb)提示符。
设置断点。我们想在调用calculate_average(empty_data)之前暂停。
```
(Pdb) b 14  # b是break命令，在第14行设置断点
```
它会显示：Breakpoint 1 at .../debug_example.py:14
让程序运行到断点处：
```
(Pdb) c  # c是continue命令
```

程序暂停在第14行。现在可以检查变量：

(Pdb) p empty_data  # p是print命令，查看变量
[]
(Pdb) n  # n是next命令，执行下一行（单步跳过）
> .../debug_example.py(15)calculate_average()
-> total = sum(numbers)

继续单步执行，观察total和len(numbers)的值：

(Pdb) n
> .../debug_example.py(17)calculate_average()
-> average = total / len(numbers)
(Pdb) p total
0
(Pdb) p len(numbers)
0  # 找到问题！除数为0

输入q退出调试。

常用pdb命令速查表：

b [行号]: 设置断点
c: 继续运行到下一个断点
n: 单步执行（跳过函数）
s: 单步执行（进入函数）
p [表达式]: 打印变量或表达式的值
l: 列出当前代码上下文
q: 退出调试

实践练习

练习1：pdb入门

有一个函数，它接收一个字典并打印用户信息，但当键不存在时会出错。

def print_user_info(user_dict):
    name = user_dict['name']
    age = user_dict['age']
    print(f"用户: {name}, 年龄: {age}岁")

data = {'name': 'Alice'} # 缺少 'age' 键
print_user_info(data)

要求：

使用pdb调试此程序。
在print_user_info函数的第一行设置断点。
运行至断点，打印出user_dict的内容。
单步执行，观察程序在哪一行崩溃，并用p命令查看出错时的变量状态。 预期输出： 你能定位到age = user_dict['age']这行，并看到user_dict中缺少age键。

练习2：IDE调试体验

在VS Code中，打开上面的debug_example.py文件。 要求：

在左侧边栏找到"运行和调试"图标（一个带虫子的三角形），点击打开调试面板。
点击第14行（print(f"空列表平均值: …")）代码左侧的行号区域，设置一个红色断点。
点击调试面板顶部的绿色"播放"按钮启动调试。
程序暂停后，将鼠标悬停在empty_data变量上，查看其值。然后在调试控制台中输入len(empty_data)查看结果。
使用调试工具栏上的"单步跳过"（F10）按钮，一步步执行，最终在"变量"窗口中看到导致错误的ZeroDivisionError。 预期输出： 通过图形化界面，直观地看到变量变化和错误发生点。

练习3：综合调试挑战

以下代码试图将字符串列表转换为整数列表并求和，但逻辑有误。

def convert_and_sum(str_list):
    int_list = []
    for item in str_list:
        # 尝试将字符串转为整数，如果失败则跳过
        num = int(item)
        int_list.append(num)
    return sum(int_list)

data = ['10', '20', 'abc', '30']
print(convert_and_sum(data))