Python 调试神器：pdb 调试器零基础入门，告别 print 调试
在 Python 开发中，我们经常会遇到代码逻辑报错、结果不符合预期的问题，很多新手习惯用print()打印变量调试，但这种方式效率极低，还会污染代码。今天给大家分享 Python内置的轻量级调试器 pdb，无需安装第三方库，开箱即用，掌握它就能高效定位代码 bug！
一、什么是 pdb？
pdb 是 Python自带的交互式源代码调试器，支持设置断点、单步执行、查看 / 修改变量、查看调用栈、条件调试等功能，完全满足日常开发的调试需求，兼容所有 Python 环境，是 Python 开发者必备的基础技能。
二、pdb 的两种启动方式
方式 1：命令行启动（推荐，无需修改代码）
插入广告：各行各业学习千款源码就上：svipm.com.cn
直接在终端运行 Python 文件时，添加-m pdb参数，程序会在第一行代码处暂停，进入调试模式：
bash
运行
# 语法：python -m pdb 你的文件名.py python -m pdb test.py方式 2：代码中嵌入断点（灵活调试）
在需要调试的代码位置，插入pdb.set_trace()，程序运行到这一行会自动暂停，进入调试模式：
python
运行
# 导入pdb库 import pdb def add(a, b): # 在这里设置断点 pdb.set_trace() return a + b result = add(10, 20) print(result)👉 Python 3.7+ 支持更简洁的
breakpoint()，无需导入 pdb，直接写breakpoint()即可！
三、pdb 核心命令速查表（必背）
进入 pdb 调试模式后，终端会显示(Pdb)提示符，输入以下命令就能操控程序执行：
表格
| 命令 | 简写 | 功能说明 |
|---|---|---|
list | l | 查看当前代码上下文（显示当前行前后代码） |
longlist | ll | 查看当前函数 / 类的完整代码 |
next | n | 单步执行，不进入函数内部（跳过函数调用） |
step | s | 单步执行，进入函数内部（逐行调试） |
return | r | 直接执行到当前函数返回 |
continue | c | 继续执行，直到下一个断点或程序结束 |
break | b | 设置断点：b 行号/b 函数名 |
clear | cl | 删除断点：cl 断点编号 |
print | p | 打印变量值：p 变量名 |
pp | - | 格式化打印变量（适合列表 / 字典等复杂数据） |
quit | q | 退出 pdb 调试 |
help | h | 查看帮助文档 |
where | w | 查看当前调用栈 |
四、实战演示：用 pdb 调试 bug
我们写一个有逻辑错误的代码，用 pdb 一步步定位问题：
1. 待调试代码（test.py）
python
运行
def calculate_sum(n): total = 0 for i in range(n): # 逻辑错误：应该是total += i，写成了total = i total = i return total # 预期结果：0+1+2+3+4=10，实际结果错误 result = calculate_sum(5) print(f"计算结果：{result}")2. 启动调试
终端执行命令，进入调试模式：
bash
运行
python -m pdb test.py3. 调试步骤（跟着敲命令）
- 输入
ll，查看完整代码，定位函数位置； - 输入
b 5，在第 5 行（循环内）设置断点； - 输入
c，运行到断点处； - 输入
p i，打印循环变量i的值； - 输入
p total，打印累计值total，发现total没有累加，定位到逻辑错误； - 输入
q，退出调试，修复代码。
五、常用高级技巧
1. 条件断点
只在满足特定条件时触发断点，适合循环调试：
python
运行
# 命令行设置：当i==3时触发断点 (Pdb) b 5, i==32. 动态修改变量
调试过程中可以直接修改变量值，测试不同场景：
python
运行
# 修改变量a的值为100 (Pdb) p a 50 (Pdb) a = 1003. 查看函数参数
输入args（简写a），快速查看当前函数的传入参数：
python
运行
(Pdb) args a = 10, b = 20六、pdb vs print 调试：为什么推荐 pdb？
- 无代码污染：无需在代码中插入大量 print，调试完无需删除；
- 实时交互：随时查看、修改变量，无需重新运行程序；
- 精准定位：直接暂停到错误代码行，逐行排查逻辑；
- 零依赖：Python 内置，无需安装任何库，适配所有环境。
七、总结
pdb 是 Python 最简单、最实用的调试工具，新手只需掌握 **n/s/c/p/q/l这 6 个核心命令 **，就能解决 90% 的调试问题。告别低效的 print 调试，从今天开始用 pdb 提升你的开发效率！
💡 小贴士：调试完成后，记得删除代码中的pdb.set_trace()或breakpoint()，避免程序运行时意外暂停哦～
总结
- pdb 是 Python内置调试器，零依赖、开箱即用；
- 两种启动方式：命令行
python -m pdb 文件名.py、代码中breakpoint()； - 核心命令：
n(单步跳过)、s(单步进入)、c(继续)、p(打印变量)、q(退出)； - 适合所有 Python 项目，高效替代 print 调试。