零基础学习PDB命令行调试Python代码

本文由 伯乐在线PyPer 翻译,艾凌风 校稿。未经许可,禁止转载!
英文出处:howchoo.com。欢迎加入翻译组

你有多少次陷入不得不更改别人代码的境地?如果你是一个开发团队的一员,那么你遇到上述境地的次数比你想要的还要多。然而,Python中有一个整洁的调试特性(像其他大多数语言一样),在这种情况下使用非常方便。本文是一篇快速教程,希望它能让你的编码生活更加容易。

1. 一个混乱的程序

出于本教程的目的,让我们研究一下下面的简单程序。

这个程序接收两个命令行参数,然后执行加法和减法操作。

(假设用户输入的是有效值,因此代码中我们没有进行错误处理。)

Python

1
2
3
4
5
6
7
8
9
10
11
12
13
14
import sys
def add(num1=0, num2=0):
    return int(num1) + int(num2)
def sub(num1=0, num2=0):
    return int(num1) int(num2)
def main():
    #Assuming our inputs are valid numbers
    print sys.argv
    addition = add(sys.argv[1], sys.argv[2])
    print addition
    subtraction = sub(sys.argv[1], sys.argv[2])
    print subtraction
if __name__ == ‘__main__’:
    main()

2. PDB

Python提供了一个有用的模块PDB,它实际上是一个交互式源代码调试器。

你需要下面的两行代码来使用此模块。

Python

1
2
import pdb
pdb.set_trace()


看一下我们修改过的程序,里面包含了一些断点。

Python

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
import pdb
import sys
def add(num1=0, num2=0):
    return int(num1) + int(num2)
def sub(num1=0, num2=0):
    return int(num1) int(num2)
def main():
    #Assuming our inputs are valid numbers
    print sys.argv
    pdb.set_trace() # <-- Break point added here
    addition = add(sys.argv[1], sys.argv[2])
    print addition
    subtraction = sub(sys.argv[1], sys.argv[2])
    print subtraction
if __name__ == ‘__main__’:
    main()

3. 程序执行触发调试器

一旦你设置好断点以后,你就可以像平时一样执行程序。

Python

1
python debugger.py 1 2

程序将会在遇到的第一个断点处停止执行。

Python

1
2
3
4
[&#039;debugger.py']
&gt; /Users/someuser/debugger.py(15)main()
&gt; addition = add(sys.argv[1], sys.argv[2])
(Pdb)

我们在第14行设置了一个断点,所以我们能看到将要执行的下一行是第15行。可以看到,在执行到第15行之前程序已经停止。

在这里我们有几个选项,让我们在下面步骤中看看一些调试指令。

4. 下一行->n

在你的调试器提示中,输入n运行到下一行。

Python

1
2
3
4
5
&gt; /Users/someuser/debugger.py(14)main()
&gt; addition = add(sys.argv[1], sys.argv[2])
(Pdb) n
&gt; /Users/someuser/debugger.py(15)main()
&gt; print addition

这会执行当前行代码,并准备执行下一行。

我们可以使用n来逐行执行整个程序,但这其实没有什么用处。

可能你已经看到,PDB实际上并没有进入我们的add函数中。下面,就让我们看看其他几个令调试更加有趣的选项。

注意:
一个更酷的特性是你可以单击回车键来执行以前的命令(在本例中只要指令n)。

5. 打印->p

下面,我们再次开始调试程序。(你可以通过单击c使PDB跳到末尾或者直到下一个断点,因为程序中我们并没有其他的断点了,所有程序将会执行完成。)

Python

1
2
3
4
[&#039;debugger.py', '1', '2']
&gt; /Users/someuser/debugger.py(14)main()
&gt; addition = add(sys.argv[1], sys.argv[2])
(Pdb)

现在,如果我们想知道sys.argv中包含什么内容,我们可以输入以下内容:

Python

1
2
3
4
5
6
&gt; addition = add(sys.argv[1], sys.argv[2])
(Pdb) p sys.argv
[&#039;debugger.py', '1', '2']
(Pdb) p sys.argv[1]
&#039;1'
(Pdb)

使用这种方法可以相当方便地查看变量中实际存储着什么值。

现在我们将进入加法函数内部。

6. 单步->s

我们可以使用“s”进入加法函数内部。

Python

1
2
3
4
5
6
7
8
(Pdb) s
Call
&gt; /Users/someuser/debugger.py(4)add()
&gt; def add(num1=0, num2=0):
(Pdb) n
&gt; /Users/someuser/debugger.py(5)add()
&gt; return int(num1) + int(num2)
(Pdb)

这将把我们带入加法函数的内部,现在我们可以在加法函数内部使用n、p和其他的操作指令。

此时单击“r”将会把我们带到前面进入函数的返回语句。

如果你想快速跳转到一个函数的结尾处,那么这个指令将很有用。

7. 动态添加断点- > b

前面,在程序运行之前,我们使用pdb.set_trace()设置了一个断点。

不过,经常在调试会话已经开始之后,我们想要在程序中特定的地方添加断点。

这里我们就可以使用选项“b”来实现这种目的。

我们重新开始执行程序。

Python

1
2
3
4
[&#039;debugger.py', '1', '2']
&gt; /Users/someuser/debugger.py(15)main()
&gt; addition = add(sys.argv[1], sys.argv[2])
(Pdb)

此时我在第18行设置一个断点。

Python

1
2
3
4
5
6
7
8
9
10
11
&gt; addition = add(sys.argv[1], sys.argv[2])
(Pdb) b 18
Breakpoint 1 at /Users/someuser/debugger.py:18
(Pdb) c
We are in add
3
&gt; /Users/someuser/debugger.py(18)main()
&gt; print subtraction
(Pdb) p subtraction
1
(Pdb)

从上面我们可以看到,PDB跳到了第18行并等待下一个指令。

同时,PDB还为该断点分配了一个号码(在本例中是1)。为了以后的执行,我们可以通过开启或禁用断点号码来启用或停用对应的断点。

8. 列表->l

有时在调试的时候,你可能会忘记此时你处在代码的什么地方。在这种情况下,使用“l”将会打印出一个友好的总结,它能够显示出此刻你在代码中的位置。

Python

1
2
3
4
5
6
7
8
9
10
11
12
13
[&#039;debugger.py', '1', '2']
&gt; /Users/someuser/debugger.py(15)main()
&gt; addition = add(sys.argv[1], sys.argv[2])
(Pdb) l
10
11     def main():
12         #Assuming our inputs are valid numbers
13         print sys.argv
14         pdb.set_trace() # <– Break point added here
15  &gt;     addition = add(sys.argv[1], sys.argv[2])
16         print addition
17         subtraction = sub(sys.argv[1], sys.argv[2])
18         print subtraction

9. 动态分配变量

在调试会话期间,你可以分配变量来帮助你进行调试,知道这些对你来说也是有帮助的。例如:

Python

1
2
3
4
5
6
7
8
9
10
11
12
13
14
[&#039;debugger.py', '1', '2']
&gt; /Users/someuser/debugger.py(15)main()
&gt; addition = add(sys.argv[1], sys.argv[2])
(Pdb) n
We are in add
&gt; /Users/someuser/debugger.py(16)main()
&gt; print addition
(Pdb) p addition
3 #<— addition here is 3
(Pdb) addition = &#039;this is now string' #<— We changed the value of additon
(Pdb) n
this is now string #<— Now when we print it we actually gets it as a string. that we just set above.
&gt; /Users/someuser/debugger.py(17)main()
&gt; subtraction = sub(sys.argv[1], sys.argv[2])

注意:
如果你想设置一些如n(即PDB指令)这样的变量,你应该使用这种指令:

Python

1
2
3
(Pdb) !n=5
(Pdb) p n
5

10. 结束->q

最后,在代码的任何地方如果你想结束调试,可以使用“q”,那么正在执行的程序将会终止。

11. 扩展阅读

本文只涉及到了PDB的表面用法,其实使用PDB你还可以做到更多(PDB 文档)。

使用IPython的人可以在ipdb中找到一个更好的调试器,它提供了tab补充、语法高亮和其他一些很酷的特性。

1
3 收藏

评论





关于作者:PyPer


一名就读于羊城某高校的学生,主要关注 Python、Perl 、PowerShell等脚本技术,新浪微博:http://weibo.com/LIwianwpIO。


个人主页 ·
我的文章

· 11

转载自演道,想查看更及时的互联网产品技术热点文章请点击http://go2live.cn