还在用print()语句来调试Python代码？快停止吧

用print()的缺点

我就是使用print()语句调试代码的人之一。有些时候，如果代码很长，那么就会有更多的打印，需要使用多个符号来相互区分。

看看下面的代码片段。(本博客中的代码片段，遵循Python 3.7的语法)

print(style_dict,"{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{}}}}}}}}}}}}}}}}}}}}}}}}}}]]]]]]]]]]]]]]]]]]]") 
# Adding into a dictionary 
res_dct = {style_dict[i]: style_dict[i + 1] for i in range(0, len(style_dict), 2)} 
res_dist={res_dct['Email Address']:{style_dict[i]: style_dict[i + 1] for i in range(0, len(style_dict), 2)}} 
print(res_dist,"+++++++++++++++++++++++++++++++++++++++++++++++++++++") 
recon_dict = res_dct 
print(recon_dict,"---------------------------------------------------") 
# Removing space so that data can be transferred to HTML fields 
recon_dict = {x.translate({32: None}): y 
              for x, y in list(recon_dict.items())} 
print("##################################################") 
print(recon_dict) 
print("################################################") 
 
# Converting to JSON 
r = json.dumps(recon_dict) 
print("$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$") 
print(r) 
loaded_json = json.loads(r) 
print("WWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWwwwwww") 
print("******************************************************") 
print(loaded_json) 

在这里，我试图将一个字典添加到一个JSON文件。由于一些错误，我不得不使用那么多带有不同符号的打印语句进行调试。

但是随着代码变得越来越大，不同的模块和不同的类调用其他模块或类中的不同定义，这不是一个好的选择。

让我们看看这种方法的一些缺点:

• 随着代码的增加，很难在代码遍历的每个模块、类或定义中使用print语句。
• 甚至在我们注意到错误之前，代码就已经执行并进入下一步。
• 等到一个漫长的执行完成后再查找并修复。
• 回到大量的日志中去搜索我们在print语句中给出的正确符号并匹配它们是很乏味的。

一个简单的转变

除了使用Python提供给我们的强大武器“pdb模块”，我们不需要做任何事情。这个模块帮助我们有效地调试。

什么是pdb(python调试器)?

 

pdb是一个交互式shell，有助于调试python代码。它帮助我们一步一步地进入代码、暂停、检查状态并继续下一行代码或继续执行。

调用pdb的一些方法：

在这里，我们将介绍三种调用pdb的方法。

• Postmortem：如果您想在程序级别进行调试，请使用此功能。
• Inline pdb：适用比3.7版本更早的版本
• breakpoint()：对于版本3.7或更高的版本

postmortem

让我们用一个简单的程序来理解。

def add_num(listA,num): 
    sum=[] 
    for i in listA: 
        sum.append(i*num) 
    return sum 
 
listA = [2, 4, 6, 8] 
num=10 
result=add_num(listA,num) 
print(result) 

在这里，def add_num应该将num变量的值添加到名为listA的列表中的每个元素中，在列表sum中存储新值，并返回列表sum。

通过执行下面所示的python文件，将调用pdb，

python -m pdb debug_add.py 

这将进入pdb模式，并在第一行代码处停止。

(venv) C:\Users\PycharmProjects\>python -m pdb debug_add.py 
> c:\users\pycharmprojects\debug_add.py(2)<module>() 
-> def add_num(listA,num): 
(Pdb) 

任何时候，如果您需要调试器的帮助，请使用' h '(帮助)，它列出了所有的选项。

(Pdb) hDocumented commands (type help <topic>): 
======================================== 
EOF    c          d        h         list      q        rv       undisplay 
a      cl         debug    help      ll        quit     s        unt 
alias  clear      disable  ignore    longlist  r        source   until 
args   commands   display  interact  n         restart  step     up 
b      condition  down     j         next      return   tbreak   w 
break  cont       enable   jump      p         retval   u        whatis 
bt     continue   exit     l         pp        run      unalias  whereMiscellaneous help topics: 
========================== 
exec  pdb 

对特定选项的帮助，

(Pdb) h debug 
debug code 
        Enter a recursive debugger that steps through the code 
        argument (which is an arbitrary expression or statement to                     
        be executed in the current environment). 

返回程序，使用选项' n ' (next)进入执行的下一个步骤。

> c:\users\pycharmprojects\debug_add.py(2)<module>() 
-> def add_num(listA,num): 
(Pdb) n 
> c:\users\prade\pycharmprojects\jobportal\debug_add.py(8)<module>() 
-> listA = [2, 4, 6, 8] 

在这里，我们可以通过给出如下变量名称来检查变量的值，

(Pdb) listA 
*** NameError: name 'listA' is not defined 
(Pdb) 
*** NameError: name 'listA' is not defined 

我们到达listA =[2,4,6,8]这一行，但我们仍然没有执行，所以它说listA未定义。如果您观察到我们在任何时候按enter键，前面的选项就会像上面那样执行。

现在按' n '向前移动并检查listA变量。

(Pdb) n 
> c:\users\pycharmprojects\debug_add.py(9)<module>() 
-> num=10 
(Pdb) listA 
[2, 4, 6, 8] 
(Pdb) 

要检查我们所在的代码行，请使用选项' l ' (line)。箭头标记指向我们所在的行，EOF表示文件结束。

(Pdb) l 
  4         for i in listA: 
  5             sum.append(i*num) 
  6         return sum 
  7 
  8     listA = [2, 4, 6, 8] 
  9  -> num=10 
 10     result=add_num(listA,num) 
 11     print(result) 
[EOF] 
(Pdb) 

要退出调试器，我们使用选项' q ' (quit)。

(Pdb) q 
(venv) C:\Users\PycharmProjects\> 

使用postmortem方法的另一种方法是仅在遇到异常时停止执行，因为使用-c继续使用-m pdb

python -m pdb -c continue debug_add.py 

[[355849]]

Breakpoint()

从Python 3.7开始，引入了breakpoint()，这有助于调试Python代码，而不必显式地导入模块pdb并调用pdb.set_trace()。breakpoint()为我们完成所有这些工作，并在控制台中打开PDB调试器。

现在，让我们在没有任何断点的情况下执行上述代码，并在遇到任何错误时进行调试。

def add_num(listA,num): 
    sum=[] 
    for i in listA: 
        sum.append(i*num) 
    return sum 
 
listA = [2, 4, 6, 8] 
num=10 
result=add_num(listA,num) 
print(result) 

输出：

C:\Users\PycharmProjects\venv\Scripts\python.exe C:/Users/PycharmProjects/debug_add.py 
[20, 40, 60, 80]Process finished with exit code 0 

代码块的任务是将num(10)添加到列表中的每个元素中，并返回新的列表。

• 预期结果为[12,14,16,18]
• 实际结果为[20,40,60,80]

现在让我们使用breakpoint()武器来调试和修复代码。

放置断点()的位置取决于怀疑错误的位置。在本例中，我们在它进入add_num()定义之前放置它。

def add_num(listA,num): 
    sum=[] 
    for i in listA: 
        sum.append(i*num) 
    return sum 
 
listA = [2, 4, 6, 8] 
num=10 
breakpoint() 
result=add_num(listA,num) 
print(result) 

输出：

> c:\users\pycharmprojects\debug_add.py(11)<module>() 
-> result=add_num(listA,num) 
(Pdb) n 
> c:\users\pycharmprojects\debug_add.py(12)<module>() 
-> print(result) 
(Pdb) n 
[20, 40, 60, 80] 
 — Return —  
> c:\users\prade\pycharmprojects\jobportal\debug_add.py(12)<module>()->None 
-> print(result) 
(Pdb) 

选项' n ' (next)用于在任何定义上移动到下一行或步骤。但在本例中，我们需要进入定义，为此我们将使用选项' s ' (step)。

在粗体文本下面是用来突出显示所使用的选项及其解释。

> c:\users\prade\pycharmprojects\jobportal\debug_add.py(11)<module>() 
-> result=add_num(listA,num) 
(Pdb) s  <----- Step into def add_num 
--Call-- 
> c:\users\prade\pycharmprojects\jobportal\debug_add.py(2)add_num() 
-> def add_num(listA,num): 
(Pdb) s  <---- stepped inside def add_num 
> c:\users\prade\pycharmprojects\jobportal\debug_add.py(3)add_num() 
-> sum=[] 
(Pdb) n  <--- inside a def feel free to use 'n' 
> c:\users\prade\pycharmprojects\jobportal\debug_add.py(4)add_num() 
-> for i in listA: 
(Pdb) n  
> c:\users\prade\pycharmprojects\jobportal\debug_add.py(5)add_num() 
-> sum.append(i*num) 
(Pdb) n 
> c:\users\prade\pycharmprojects\jobportal\debug_add.py(4)add_num() 
-> for i in listA: 
(Pdb) sum  <-- examine sum value 
[20] <--- 2+10 =12 not 20,oops we used '*'instead of '+' in       
                          appending to list sum,CAUGHT IT! 
(Pdb) i  <-- so, examine i 
2 
(Pdb) sum.append(i+num) <-- try adding + in the expression 
(Pdb) sum 
[20, 12] <-- PERFECT, FIXED IT! 
(Pdb) u <-- used to skip other iterations of for loop. 
> c:\users\prade\pycharmprojects\jobportal\debug_add.py(11)<module>() 
-> result=add_num(listA,num) 
(Pdb) c <-- used to continue with execution 
[20, 12, 40, 60, 80] <--not a right answer but found a fix.Process finished with exit code 0 

上面，在for循环的第一次迭代之后，我们检查了sum值，结果显示为20，而不是12。我们差点在这里发现我们用*(乘法)代替了+(加法)因此，我们向前迈出一步，检查' i '在那一点上是2，并尝试了sum.append(i+num)。然后检验和，得到12是最近添加的元素。因此我们得到了修复，因此我们使用选项' u ' (until)跳过了for循环的剩余迭代。然后它移动到循环后的下一步。这里我们使用' c ' (continue)来继续执行，结果就结束了。

现在修复,

def add_num(listA,num): 
    sum=[] 
    for i in listA: 
        sum.append(i+num) 
    return sum 
 
listA = [2, 4, 6, 8] 
num=10 
result=add_num(listA,num) 
print(result) 

输出：

C:\Users\PycharmProjects\venv\Scripts\python.exe C:/Users/PycharmProjects/debug_add.py 
[12, 14, 16, 18]Process finished with exit code 0 

没有乱七八糟的print()语句，这看起来很简单。