模块 pdb 是 Python 的一个交互式代码调试器，它支持在源代码行级别设置（条件）断点和单步执行等。
一、pdb 执行中用到的命令
| 参数 | 说明 | 示例 |
|---|---|---|
h(elp) [command] |
帮助文档 |
h b： 查看 b 命令的文档 |
l(ist) [first[, last]] |
列出当前或范围周围代码 |
l 5, 20： 列出5到20行代码 l： 查看当前位置的代码 |
b(reak) [[ filename: ] lineno | function [, condition ]] |
打断点 |
b 5： （给第5行打断点）b function_name：（当前文件函数名为 function_name 的函数打断点) b test1.A.add：在 import test1 文件的 A 类的 add 方法打断点 b A.add：在 A 类的 add 方法打断点 |
w(here) |
查看当前执行的位置 | w |
tbreak [[ filename: ] lineno | function [, condition ]] |
设置临时断点，运行完毕后会删除这个断点 | 设置方法和 b 一样 |
cl(ear) [filename:lineno | bpnumber [bpnumber …]] |
清除断点 |
cl：清除所有断点 cl 2：清除断点列表中第2个断点 cl test.py:18：清除 test.py 文件的第18行的断点 cl test1:18：清除 import test1 文件的第18行断点 |
disable [bpnumber [bpnumber …]] |
停用断点 | 用法和 cl 一样 |
enable [bpnumber [bpnumber …]] |
启动断点 | 用法和 cl 一样 |
ignore bpnumber [count] |
忽略某个断点几次 |
ignore 1 3：忽略断点列表中第1个断点3次，一般循环中用，可以查看下面 忽略断点示例
|
condition bpnumber [condition] |
给断点设置条件 |
condition 1 i==4：当断点列表中第1个断点中变量 i 等于 4 的时候执行断点 |
commands [bpnumber] |
给断点写一个脚本执行 | 查看下面 断点脚本示例
|
s(tep) |
执行下一条命令，如果本句是函数调用，则 s 会执行到函数的第一句 |
示例参考下面的 s 执行效果示例
|
n(ext) |
执行下一条语句，如果本句是函数调用，则执行函数，接着执行当前执行语句的下一条。 | 示例参考下面的 n 执行效果示例
|
unt(il) |
执行到下一行 | 参考下面 unt 执行效果
|
r(eturn) |
执行当前运行函数到结束 | |
c(ontinue) |
继续执行，直到遇到下一条断点 | |
j(ump) lineno |
跳转至指定程序行（如果是前行，则忽略中间行代码。如果是后退，状态重设为回退行状态） |
j 执行效果
|
a(rgs) |
显示当前所有变量 | |
p expression |
打印出当前所在函数中的变量或表达式结果 |
p params：打印 params 参数 |
pp expression |
格式化打印出来的结果 |
pp params：打印 params 参数 |
alias [name [command]] |
自定义一个函数，参数可由％1，％2来表示，类似 Python 的 lambda
|
用法参考 定义临时函数
|
unalias name |
删掉别名函数 | unalias name |
run [args …] |
重新执行 | |
q |
退出 |
二、示例
-
忽略断点示例
test.py
import pdb; pdb.set_trace()
for i in range(10):
print i
命令行执行
$ python test.py
> /Users/machao-mac/Desktop/test.py(2)<module>()
-> for i in range(10):
(Pdb) b 3
Breakpoint 1 at /Users/machao-mac/Desktop/test.py:3
(Pdb) condition 1 i==4
(Pdb) c
0
1
2
3
> /Users/machao-mac/Desktop/test.py(3)<module>()
-> print i
(Pdb) q
-
断点脚本示例
test.py
import pdb; pdb.set_trace()
for i in range(10):
print i
在命令行执行
$ python test.py
> /Users/machao-mac/Desktop/test.py(2)<module>()
-> for i in range(10):
(Pdb) b 3
Breakpoint 1 at /Users/machao-mac/Desktop/test.py:3
(Pdb) commands 1 给断点编号为1的的断点写脚本
(com) print i * 2
(com) end 结束命令
(Pdb) c
0
> /Users/machao-mac/Desktop/test.py(3)<module>()
-> print i
(Pdb) c
0
2
> /Users/machao-mac/Desktop/test.py(3)<module>()
-> print i
(Pdb) c
1
4
> /Users/machao-mac/Desktop/test.py(3)<module>()
-> print i
-
n执行效果示例
test.py
import pdb; pdb.set_trace()
class A():
def __inif__(self):
print 123
def add(self, one, two):
new_one = self.addd(one)
return new_one + two
def addd(self, ones):
one_one = ones + 10
return one_one
aa = A()
print aa.add(1, 2)
命令行执行 s
$ python test.py
> /Users/machao-mac/Desktop/test.py(3)<module>()
-> class A():
(Pdb) b 7
Breakpoint 1 at /Users/machao-mac/Desktop/test.py:7
(Pdb) c
> /Users/machao-mac/Desktop/test.py(7)A()
-> def add(self, one, two):
(Pdb) s
> /Users/machao-mac/Desktop/test.py(11)A()
-> def addd(self, ones):
(Pdb) q
命令行执行 c
> /Users/machao-mac/Desktop/test.py(3)<module>()
-> class A():
(Pdb) b 7
Breakpoint 1 at /Users/machao-mac/Desktop/test.py:7
(Pdb) c
> /Users/machao-mac/Desktop/test.py(7)A()
-> def add(self, one, two):
(Pdb) c
13
对比 s 和 c 可以发现 c 直接结束，而 s 执行到下一个函数的开头
-
s执行效果示例
命令行执行效果
$ python test.py
> /Users/machao-mac/Desktop/test.py(3)<module>()
-> class A():
(Pdb) b 8
Breakpoint 1 at /Users/machao-mac/Desktop/test.py:8
(Pdb) c
> /Users/machao-mac/Desktop/test.py(8)add()
-> new_one = self.addd(one)
(Pdb) n
addd
> /Users/machao-mac/Desktop/test.py(9)add()
-> return new_one + two
对比上面 s 的示例可以发现，n 示例中 已经执行完 addd 函数
-
unt执行效果
text.py
import pdb; pdb.set_trace()
class A():
def __inif__(self):
print 123
def add(self, one, two):
new_one = self.addd(one)
return new_one + two
def addd(self, ones):
one_one = ones + 10
print 'addd'
return one_one
aa = A()
print aa.add(1, 2)
命令行执行效果
$ python test.py
> /Users/machao-mac/Desktop/test.py(3)<module>()
-> class A():
(Pdb) b 8
Breakpoint 1 at /Users/machao-mac/Desktop/test.py:8
(Pdb) c
> /Users/machao-mac/Desktop/test.py(8)add()
-> new_one = self.addd(one)
(Pdb) n
addd
> /Users/machao-mac/Desktop/test.py(9)add()
-> return new_one + two
-
j执行效果
import pdb; pdb.set_trace()
print 1
print 2
print 3
print 4
print 5
print 6
print 7
print 8
$ python test.py
> /Users/machao-mac/Desktop/test.py(3)<module>()
-> print 1
(Pdb) jump 7
> /Users/machao-mac/Desktop/test.py(7)<module>()
-> print 5
(Pdb) c
5
6
7
8
-
alias定义临时函数
test.py
import pdb; pdb.set_trace()
class A():
def __inif__(self):
print 123
def add(self, one, two):
new_one = self.addd(one)
return new_one + two
def addd(self, ones):
one_one = ones + 10
print 'addd'
return one_one
aa = A()
print aa.add(1, 2)
命令行执行效果
> /Users/machao-mac/Desktop/test.py(4)<module>()
-> class A():
(Pdb) b 10
Breakpoint 1 at /Users/machao-mac/Desktop/test.py:10
(Pdb) c
addd
> /Users/machao-mac/Desktop/test.py(10)add()
-> return new_one + two
(Pdb) a
self = <__main__.A instance at 0x10a61d290>
one = 1
two = 2
(Pdb) p one
1
(Pdb) alias pi print %1
(Pdb) pi one
1
(Pdb)
