pdb是ptyhon内置的一个调试库，是调试python代码的好帮手，本文是对其用法的详细介绍。

QuickStart

待调试的代码内容

文件名：test.py：

# coding:utf-8

import pdb

s1 = 'aaa'

pdb.set_trace()

s2 = 'bbb'

s3 = 'ccc'

pdb.set_trace()

s = s1 + s2 + s3

print s

可以看出在代码的第4、7行分别打了一个断点，使用的是pdb.set_trace()函数。

开始调试

在和代码文件相同路径下打开命令行窗口，输入命令：python test1.py

接着就进入了调试状态：

(.env) E:\code\python-basic\tools\pdb\sample>python test1.py

> e:\code\python-basic\tools\pdb\sample\test1.py(5)()

-> s2 = 'bbb'

(Pdb)

可以看出直接执行到了第一个断点所在的下一行，并停在了这里。

这时可以执行命令：n进行下一步：

(Pdb) n

> e:\code\python-basic\tools\pdb\sample\test1.py(6)()

-> s3 = 'ccc'

(Pdb)

使用p 命令打印已经出现过的变量的值：

(Pdb) p s1

'aaa'

(Pdb) p s2

'bbb'

(Pdb) p s3

*** NameError: NameError("name 's3' is not defined",)

(Pdb)

因为当前变量s3还没有被赋值，所以打印s3的时候提示NameError异常。

使用l命令打印出当前的代码段：

(Pdb) l

1 # coding:utf-8

2 import pdb

3 s1 = 'aaa'

4 pdb.set_trace()

5 s2 = 'bbb'

6 -> s3 = 'ccc'

7 pdb.set_trace()

8 s = s1 + s2 + s3

9 print s

[EOF]

(Pdb)

退出调试：q命令

(Pdb) q

Traceback (most recent call last):

File "test1.py", line 6, in

s3 = 'ccc'

File "test1.py", line 6, in

s3 = 'ccc'

File "d:\programs\python27\Lib\bdb.py", line 49, in trace_dispatch

return self.dispatch_line(frame)

File "d:\programs\python27\Lib\bdb.py", line 68, in dispatch_line

if self.quitting: raise BdbQuit

bdb.BdbQuit

(.env) E:\code\python-basic\tools\pdb\sample>

PDB调试的另一种方式

QuickStart中使用的调试方式不够优雅，因为是通过修改代码的方式打断点的，用起来不太方便。那么能不能动态打断点呢？答案是当然可以，请接着往下看。

准备待调试的代码

删除掉QuickStart中代码中的pdb.set_trace()，剩下的代码如下：

文件名：test2.py

# coding:utf-8

s1 = 'aaa'

s2 = 'bbb'

s3 = 'ccc'

s = s1 + s2 + s3

print s

开始调试

在test2.py相同路径下打开命令行，输入命令：python -m pdb test2.py

(.env) E:\code\python-basic\tools\pdb\sample>python -m pdb test2.py

> e:\code\python-basic\tools\pdb\sample\test2.py(2)()

-> s1 = 'aaa'

(Pdb) l

1 # coding:utf-8

2 -> s1 = 'aaa'

3 s2 = 'bbb'

4 s3 = 'ccc'

5 s = s1 + s2 + s3

6 print s

[EOF]

(Pdb)

可以看到当前代码中我们还没有打任何断点，代码默认停在了第1行。

执行一个命令n：

(Pdb) n

> e:\code\python-basic\tools\pdb\sample\test2.py(3)()

-> s2 = 'bbb'

(Pdb) l

1 # coding:utf-8

2 s1 = 'aaa'

3 -> s2 = 'bbb'

4 s3 = 'ccc'

5 s = s1 + s2 + s3

6 print s

[EOF]

(Pdb)

可以看到单步执行到了下一行。

如果我们想在第5行打一个断点，该怎么打呢？用b 命令在某一行打一个断点：

(Pdb) b 5

Breakpoint 1 at e:\code\python-basic\tools\pdb\sample\test2.py:5

(Pdb) l

[EOF]

(Pdb) n

> e:\code\python-basic\tools\pdb\sample\test2.py(4)()

-> s3 = 'ccc'

(Pdb) l

1 # coding:utf-8

2 s1 = 'aaa'

3 s2 = 'bbb'

4 -> s3 = 'ccc'

5 B s = s1 + s2 + s3

6 print s

[EOF]

(Pdb)

这样就成功地在第5行打了一个断点。

查看当前打了哪些断点：b命令

(Pdb) b

Num Type Disp Enb Where

1 breakpoint keep yes at e:\code\python-basic\tools\pdb\sample\test2.py:5

(Pdb)

PDB调试命令汇总

高级命令

以上的示例只是展示了最简单的顺序结构的代码的调试方法，而实际应用中遇到的大多数代码都有着较为复杂的逻辑结构，比如循环结构、分支结构、调用函数、调用其他模块的函数、使用类和对象等等。

针对这些场景还有很多更高级的调试命令，其实掌握了前面的几个简单的命令的用法后，下面的这些更高级的命令就都很容易上手了，多用几遍就能很快掌握了。

命令

命令全称

功能

h

help

查看帮助

n

next

执行下一条语句

s

step

执行下一条语句，如果是函数，则会执行到函数的第一句

b

break

列出当前的所有断点

b

/

在某一行打一个断点

b :

/

在某个文件的某行打一个断点

b

/

在某个函数的第一行打一个断点

cl

clear

清除所有断点

cl n1 n2 ...

/

清除编号为n1、n2...的断点

cl

/

清除某行的断点

cl :

/

清除某个文件某行的断点

r

return

执行当前函数到结束

c

continue

执行到下一个断点

l

list

列出源码(前后11行代码)

l

/

列出某行周围11行代码

l

/

列出两个行号范围内的代码

p

print

输出变量的值

pp

/

好看一点的输出

q

quit

退出debug

unt

until

退出循环或当期堆栈

run

/

重新启动debug

a

args

列出当前执行的函数的参数

w

where

打印当前执行堆栈

注：平时使用的时候通常用的都是各个命令的简写形式，当然用全称也是可以的(如果不嫌麻烦的话)。

补充

在命令行中进入调试模式的方法：python -m pdb demo.py

在调试模式中按一下Enter键表示执行一下上一条命令。

在ipython中使用PDB(体验更好)：%run -d demo.py