0Pricing
Python Academy · 课时

使用 pdb 调试

使用 Python 内置调试器交互式地逐步执行代码。

使用 pdb 调试 是 CoddyKit 上的免费 Python Academy 课时。 这是第 4 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Python Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Python Academy 课程共包含 4 节课。

什么是 pdb？

pdb 是 Python 内置的交互式调试器。它可以暂停执行、检查变量，并逐行执行代码。

import pdb

def faulty(n):
    result = n * 2
    pdb.set_trace()   # execution pauses here
    return result + 1

faulty(5)

breakpoint() — Python 3.7+

breakpoint() 是 import pdb; pdb.set_trace() 的内置简写形式，并且会遵循 PYTHONBREAKPOINT 环境变量。

def process(data):
    for item in data:
        if item < 0:
            breakpoint()   # drop into pdb here
        print(item)

process([1, -2, 3])

pdb 核心命令

基本命令包括：n（下一行）、s（步入）、c（继续）、q（退出）、p expr（打印）、l（列出源代码）。

# Inside pdb prompt:
# (Pdb) n          — execute next line
# (Pdb) s          — step into function
# (Pdb) c          — continue to next breakpoint
# (Pdb) p my_var   — print value
# (Pdb) l          — show source around current line
# (Pdb) q          — quit

检查变量

使用 p 打印表达式，使用 pp 进行美化打印，并使用 locals() 查看所有局部变量。

# (Pdb) p data
# [1, -2, 3]
# (Pdb) pp {"key": "value", "num": 42}
# {'key': 'value',
#  'num': 42}
# (Pdb) p locals()

条件断点

设置条件断点，可以只在条件为真时暂停，从而避免反复单步执行。

import pdb

def process(items):
    for i, item in enumerate(items):
        if item < 0:   # manual condition
            pdb.set_trace()
        result = item * 2

# Or inside pdb: b filename.py:12, x < 0

事后调试

使用 pdb.post_mortem() 检查未处理异常发生后的状态，或者使用 python -m pdb script.py 运行您的脚本。

import pdb

try:
    1 / 0
except ZeroDivisionError:
    pdb.post_mortem()   # inspect at the crash point

# Or from CLI:
# python -m pdb my_script.py

使用 w 和 where 查看变量

w（where）会打印当前的调用栈回溯信息，让您了解程序是如何到达当前栈帧的。

# (Pdb) w
# /app/main.py(10)main()
# -> process([1,-2,3])
# /app/main.py(5)process()
# -> breakpoint()

在栈帧之间移动

u（up）和 d（down）可在调用栈的栈帧之间移动，以便检查调用函数中的变量。

# (Pdb) u   — move to calling frame
# (Pdb) d   — move back down
# (Pdb) p data   — inspect variable in that frame

ipdb — 增强型调试器

ipdb 在 pdb 的基础上提供了 IPython 功能，包括制表符补全、语法高亮和魔术命令。

# pip install ipdb
import ipdb

def calc(x):
    ipdb.set_trace()
    return x ** 2

calc(7)

pudb — 可视化终端调试器

pudb 在终端中提供全屏 TUI 调试器，其中包含代码、变量和栈面板。

# pip install pudb
# python -m pudb my_script.py

import pudb

def run():
    pudb.set_trace()
    data = [1, 2, 3]
    return sum(data)

在持续集成中禁用断点

设置 PYTHONBREAKPOINT=0，即可让持续集成或生产环境中的所有 breakpoint() 调用不执行任何操作。

# In CI pipeline:
# export PYTHONBREAKPOINT=0
# python my_script.py
# breakpoint() is silently skipped

快速检查

哪个 pdb 命令会继续执行，直到遇到下一个断点？

复习

使用 breakpoint() 暂停执行并进入 pdb。核心命令包括：n、s、c、p 和 q。如需更丰富的调试体验，请尝试 ipdb 或 pudb。在持续集成中设置 PYTHONBREAKPOINT=0 可禁用断点。

常见问题解答

「使用 pdb 调试」课时是免费的吗？

是的 — 「使用 pdb 调试」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Python Academy 课程的其余内容，请升级到 CoddyKit PRO。 Python Academy 课程共包含 4 节课。

「使用 pdb 调试」这节课中我会学到什么？

使用 Python 内置调试器交互式地逐步执行代码。 你通过在浏览器中直接运行的动手代码来练习 Python Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Python Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Python Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 4 节课，共 4 节。

「使用 pdb 调试」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Python Academy 课中编写并运行代码吗？

能。每节 Python Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

  1. logging 模块基础
  2. 处理器、格式化器与过滤器
  3. 结构化日志记录
  4. 使用 pdb 调试
← 返回 Python Academy