在Python中,语法错误可以被Python解释器发现,但逻辑上错误或变量使用错误却不容易发现,如果结果没有符合预期,则需要调试,一个很好的调试工具:Python自带的pdb模块。pdb是Python自带的调试模块。使用pdb模块可以为脚本设置断点、单步执行、查看变量值等。
pdb可以用命令行参数的方式启动,也可以使用import 将其导入后再使用。
>>> dir(pdb)
['Pdb', 'Repr', 'Restart', 'TESTCMD',.....,'re', 'run', 'runcall', 'runctx', 'runeval', 'set_trace', 'sys', 'test', 'traceback']
常见的pdb函数有以下几个:
【pdb.run()函数】
>>> 该函数主要用于调试语句块
>>> 基本用法如下
>>> help(pdb.run)
Help on function run in module pdb:
run(statement, globals=None, locals=None)
>>>参数含义
statement: 要调试的语句块,以字符串的形式表示
globals: 可选参数,设置statement运行的全局环境变量
locals: 可选参数,设置statement运行的局部环境变量
>>>简单示例
>>> import pdb # 导入调试模块
>>> pdb.run(''''' # 调用run()函数执行一个for循环
for i in range(3):
i *= 3
print(i)
''')
> <string>(2)<module>()
(Pdb) n # (Pdb)为调试命令提示符,表示可输入调试命令
> <string>(3)<module>()
(Pdb) n # n(next)表示执行下一行
> <string>(4)<module>()
(Pdb) print(i) # 打印变量i的值
0
(Pdb) continue # 继续运行程序
0
3
6
【pdb.runeval()函数】
>>>该函数主要用于调试表达式
>>>基本用法如下
>>> help(pdb.runeval)
Help on function runeval in module pdb:
runeval(expression, globals=None, locals=None)
>>> 参数含义
expression: 要调试的,
globals: 可选参数,设置statement运行的全局环境变量
locals: 可选参数,设置statement运行的局部环境变量
>>> 简单示例
>>> import pdb # 导入pdb模块
>>> lst = [1, 2, 3] # 定义一个列表
>>> pdb.runeval('lst[1]') # 调用runaval()函数来调试表达式lst[1]
> <string>(1)<module>()
(Pdb) n # 进入调试状态,使用n命令,单步执行
--Return--
> <string>(1)<module>()->2
(Pdb) n # 单步执行
2 # 返回表达式的值
>>> pdb.runeval('3 + 5*6/2') # 使用runaval()函数来调试表达式3+5*6/2
> <string>(1)<module>()->2
(Pdb) n
--Return--
> <string>(1)<module>()->18
(Pdb) n # 使用n命令单步执行
18 # 最后得出表达式的值
【pdb.runcall()函数】
>>>该函数主要用于调试函数
>>>基本用法如下
>>> help(pdb.runcall)
Help on function runcall in module pdb:
runcall(*args, **kwds)
>>> 参数含义
function: 函数名
args(kwds): 函数的参数
>>> 简单示例
>>> import pdb # 导入模块
>>> def sum(*args): # 定义函数sum,求所有参数之和
res = 0
for arg in args:
res += arg
return res
>>> pdb.runcall(sum, 1, 2, 3, 4) # 使用runcall调试函数sum
> <pyshell#53>(2)sum()
(Pdb) n # 进入调试状态,单步执行
> <pyshell#53>(3)sum()
(Pdb) n # 单步执行
> <pyshell#53>(4)sum()
(Pdb) print(res) # 使用print打印res的值
0
(Pdb) continue # 继续执行
10
>>> pdb.runcall(sum, 1, 2, 3, 4, 5, 6) # 调用runcall调试函数sum,参数不同
> <pyshell#53>(2)sum()
(Pdb) continue # 继续执行
21 # 函数最后返回结果
【pdb.set_trace()函数】
>>>该函数主要用于脚本中设置硬断点
>>>基本用法如下
>>> help(pdb.set_trace)
Help on function set_trace in module pdb:
set_trace()
>>>简单示例
# file: test.py
import pdb
pdb.set_trace()
for i in range(5):
i *= 5
print(i)
运行脚本后显示:
> d:\learn\python\test.py(6)<module>()
-> for i in range(5):
(Pdb) list # 使用list列出脚本内容
1 # file: test.py
2
3 import pdb
4
5 pdb.set_trace() # 使用set_trace()设置硬断点
6 -> for i in range(5):
7 i *= 5
8 print(i)
[EOF] # 列出脚本内容结束
(Pdb) continue # 使用continue继续执行
0
5
10
15
20
【pdb调试命令】
pdb中的调试命令可以完成单步执行、打印变量值、设置断点等功能。pdb主要命令如下
------------------------------------------------------------------------------
# 完整命令 简写命令 描述
------------------------------------------------------------------------------
# args a 打印当前函数的参数
# break b 设置断点
# clear cl 清除断点
# condition 无 设置条件断点
# continue c 继续运行,直到遇到断点或者脚本结束
# disable 无 禁用断点
# enable 无 启用断点
# help h 查看pdb帮助
# ignore 无 忽略断点
# jump j 跳转到指定行数运行
# list l 列出脚本清单
# next n 执行下条语句,遇到函数不进入其内部
# print p 打印变量值
# quit q 退出pdb
# return r 一致运行到函数返回
# tbreak 无 设置临时断点、断点只中断一次
# step s 执行下一条语句,遇到函数进入其内部
# where w 查看所在的位置
# ! 无 在pdb中执行语句
>>>简单示例
# -*- coding:gbk -*-
# file: prime.py
#
import math
# isprime函数判断一个整数是否为素数
# 如果i能被2到i的平方根内的任意一个数整除,
# 则i不是素数,返回0,否则i是素数,返回1。
def isprime(i):
for t in range(2, int(math.sqrt(i)) + 1):
if i % t == 0:
return 0
print('100~110之间素数有: ')
for i in range(100, 110):
if isprime(i):
print(i)
先运行下面命令:
d:\Learn\Python>python -m pdb prime.py
后输入以下命令:
d:\Learn\Python>python -m pdb prime.py
> d:\learn\python\prime.py(4)<module>()
-> import math
(Pdb) list # 运行前面命令后停在这里,list默认只列出11行
1 # -*- coding:gbk -*-
2 # file: prime.py
3 #
4 -> import math
5 # isprime函数判断一个整数是否为素数
6 # 如果i能被2到i的平方根内的任意一个数整除,
7 # 则i不是素数,返回0,否则i是素数,返回1。
8 def isprime(i):
9 for t in range(2, int(math.sqrt(i)) + 1):
10 if i % t == 0:
11 return 0
(Pdb) l 14,17 # 使用list命令,列出14行,到17行
14 print('100~110之间素数有: ')
15 for i in range(100, 110):
16 if isprime(i):
17 print(i)
(Pdb) b 14 # 使用break命令设置断点
Breakpoint 1 at d:\learn\python\prime.py:14 # 返回断点编号: 1
(Pdb) b isprime # 在函数isprime设置断点
Breakpoint 2 at d:\learn\python\prime.py:8 # 返回断点编号: 2
(Pdb) c # 使用c命令运行运行脚本
> d:\learn\python\prime.py(14)<module>() # 停在断点1处,即第14行
-> print('100~110之间素数有: ')
(Pdb) c # 使用c命令继续运行脚本
100~110之间素数有: # 第14行脚本输出
> d:\learn\python\prime.py(9)isprime() # 停在断点2,即isprime函数处
-> for t in range(2, int(math.sqrt(i)) + 1):
(Pdb) b 15 # 在第15行处设置断点
Breakpoint 3 at d:\learn\python\prime.py:15
(Pdb) disable 2 # 禁用断点2,即isprime函数处的断点
(Pdb) c # 使用c命令继续运行脚本
> d:\learn\python\prime.py(15)<module>() # 停在断点3处,即第15行
-> for i in range(100, 110):
(Pdb) print(i) # 使用print打印变量i的值
100
(Pdb) c # 继续运行脚本
> d:\learn\python\prime.py(15)<module>()
-> for i in range(100, 110):
(Pdb) p i # 打印i的值
101
(Pdb) enable 2 # 恢复断点2,即isprime函数处的断点
(Pdb) c # 继续运行脚本
> d:\learn\python\prime.py(9)isprime()
-> for t in range(2, int(math.sqrt(i)) + 1):
(Pdb) n # 单步执行下一条语句
> d:\learn\python\prime.py(10)isprime()
-> if i % t == 0:
(Pdb) print(t) # 使用print打印变量t的值
2
(Pdb) cl # 清楚所有断点,输入y确认
Clear all breaks? y
(Pdb) c # 继续运行脚本
103
105
107
109
(Pdb) q # 使用quit(q)退出pdb调试