求你了，别再用print调试代码了

 对于每个程序开发者来说，调试几乎是必备技能。

代码写到一半卡住了，不知道这个函数执行完的返回结果是怎样的？调试一下看看

代码运行到一半报错了，什么情况？怎么跟预期的不一样？调试一下看看

调试的方法多种多样，不同的调试方法适合不同的场景和人群。

  •  如果你是刚接触编程的小萌新，对很多工具的使用还不是很熟练，那么 print 和 log 大法好
  •  如果你在本地（Win或者Mac）电脑上开发，那么 IDE 的图形化界面调试无疑是最适合的；
  •  如果你在服务器上排查BUG，那么使用 PDB 进行无图形界面的调试应该是选择，详情请戳明哥之前的文章：让代码调试不再难 - pdb
  •  如果你要在本地进行开发，但是项目的进行需要依赖复杂的服务器环境，那么可以了解下 PyCharm 的远程调试，详情请戳明哥之前的文章：不能不会的远程调试技巧

除了以上，今天明哥再给你介绍一款非常好用的调试工具，它能在一些场景下，大幅度提高调试的效率， 那就是 PySnooper，它在 Github 上已经收到了 13k 的 star，获得大家的一致好评。

有了这个工具后，就算是小萌新也可以直接无门槛上手，从此与 print 说再见~

1. 快速安装

执行下面这些命令进行安装 PySnooper

 
 
 
 
    
  
  
  
  
  1. $ python3 -m pip install pysnooper 
    2. 
  
  
  
  
  2. # 或者 
    3. 
  
  
  
  
  3. $ conda install -c conda-forge pysnooper 
    4. 
  
  
  
  
  4. # 或者 
    5. 
  
  
  
  
  5. $ yay -S python-pysnooper
    6.

2. 简单案例

下面这段代码，定义了一个 demo_func 的函数，在里面生成一个 profile 的字典变量，然后去更新它，最后返回。

代码本身没有什么实际意义，但是用来演示 PySnooper 已经足够。

 
 
 
 
    
  
  
  
  
  1. import pysnooper 
    2. 
  
  
  
  
  2. @pysnooper.snoop() 
    3. 
  
  
  
  
  3. def demo_func(): 
    4. 
  
  
  
  
  4.     profile = {} 
    5. 
  
  
  
  
  5.     profile["name"] = "写代码的明哥" 
    6. 
  
  
  
  
  6.     profile["age"] = 27 
    7. 
  
  
  
  
  7.     profile["gender"] = "male"
    8. 
  
  
  
  
  8.      return profile 
    9. 
  
  
  
  
  9. def main(): 
    10. 
  
  
  
  
  10.     profile = demo_func() 
    11. 
  
  
  
  
  11. main()
    12.

现在我使用终端命令行的方式来运行它

 
 
 
 
    
  
  
  
  
  1. [root@iswbm ~]# python3 demo.py  
    2. 
  
  
  
  
  2. Source path:... demo.py 
    3. 
  
  
  
  
  3. 17:52:49.624943 call         4 def demo_func(): 
    4. 
  
  
  
  
  4. 17:52:49.625124 line         5     profile = {} 
    5. 
  
  
  
  
  5. New var:....... profile = {} 
    6. 
  
  
  
  
  6. 17:52:49.625156 line         6     profile["name"] = "写代码的明哥" 
    7. 
  
  
  
  
  7. Modified var:.. profile = {'name': '写代码的明哥'} 
    8. 
  
  
  
  
  8. 17:52:49.625207 line         7     profile["age"] = 27 
    9. 
  
  
  
  
  9. Modified var:.. profile = {'name': '写代码的明哥', 'age': 27} 
    10. 
  
  
  
  
  10. 17:52:49.625254 line         8     profile["gender"] = "male" 
    11. 
  
  
  
  
  11. Modified var:.. profile = {'name': '写代码的明哥', 'age': 27, 'gender': 'male'} 
    12. 
  
  
  
  
  12. 17:52:49.625306 line        10     return profile 
    13. 
  
  
  
  
  13. 17:52:49.625344 return      10     return profile
    14. 
  
  
  
  
  14. Return value:.. {'name': '写代码的明哥', 'age': 27, 'gender': 'male'} 
    15. 
  
  
  
  
  15. Elapsed time: 00:00:00.000486
    16.

可以看到 PySnooper 把函数运行的过程全部记录了下来，包括：

  •  代码的片段、行号等信息，以及每一行代码是何时调用的？
  •  函数内局部变量的值如何变化的？何时新增了变量，何时修改了变量。
  •  函数的返回值是什么？
  •  运行函数消耗了多少时间？

而作为开发者，要得到这些如此详细的调试信息，你需要做的非常简单，只要给你想要调试的函数上带上一顶帽子（装饰器） -- @pysnooper.snoop() 即可。

3. 详细使用

2.1 重定向到日志文件

@pysnooper.snoop() 不加任何参数时，会默认将调试的信息输出到标准输出。

对于单次调试就能解决的 BUG ，这样没有什么问题，但是有一些 BUG 只有在特定的场景下才会出现，需要你把程序放在后面跑个一段时间才能复现。

这种情况下，你可以将调试信息重定向输出到某一日志文件中，方便追溯排查。

 
 
 
 
    
  
  
  
  
  1. @pysnooper.snoop(output='/var/log/debug.log') 
    2. 
  
  
  
  
  2. def demo_func():
    3. 
  
  
  
  
  3.     ...
    4.

2.2 跟踪非局部变量值

PySnooper 是以函数为单位进行调试的，它默认只会跟踪函数体内的局部变量，若想跟踪全局变量，可以给 pysnooper.snoop() 加上 watch 参数

 
 
 
 
    
  
  
  
  
  1. out = {"foo": "bar"} 
    2. 
  
  
  
  
  2. @pysnooper.snoop(watch=('out["foo"]'))
    3. 
  
  
  
  
  3. def demo_func(): 
    4. 
  
  
  
  
  4.     ...
    5.

如此一来，PySnooper 会在 out["foo"] 值有变化时，也将其打印出来

watch 参数，接收一个可迭代对象（可以是list 或者 tuple），里面的元素为字符串表达式，什么意思呢？看下面例子就知道了

 
 
 
 
    
  
  
  
  
  1. @pysnooper.snoop(watch=('out["foo"]', 'foo.bar', 'self.foo["bar"]'))
    2. 
  
  
  
  
  2. def demo_func(): 
    3. 
  
  
  
  
  3.     ...
    4.

和 watch 相对的，pysnooper.snoop() 还可以接收一个函数 watch_explode，表示除了这几个参数外的其他所有全局变量都监控。

 
 
 
 
    
  
  
  
  
  1. @pysnooper.snoop(watch_explode=('foo', 'bar')) 
    2. 
  
  
  
  
  2. def demo_func(): 
    3. 
  
  
  
  
  3.     ...
    4.

2.3 设置跟踪函数的深度

当你使用 PySnooper 调试某个函数时，若该函数中还调用了其他函数，PySnooper 是不会傻傻的跟踪进去的。

如果你想继续跟踪该函数中调用的其他函数，可以通过指定 depth 参数来设置跟踪深度（不指定的话默认为 1）。

 
 
 
 
    
  
  
  
  
  1. @pysnooper.snoop(depth=2) 
    2. 
  
  
  
  
  2. def demo_func(): 
    3. 
  
  
  
  
  3.  ...
    4.

2.4 设置调试日志的前缀

当你在使用 PySnooper 跟踪多个函数时，调试的日志会显得杂乱无章，不方便查看。

在这种情况下，PySnooper 提供了一个参数，方便你为不同的函数设置不同的标志，方便你在查看日志时进行区分。

 
 
 
 
    
  
  
  
  
  1. @pysnooper.snoop(output="/var/log/debug.log", prefix="demo_func: ")
    2. 
  
  
  
  
  2. def demo_func(): 
    3. 
  
  
  
  
  3.     ...
    4.

效果如下

2.5 设置最大的输出长度

默认情况下，PySnooper 输出的变量和异常信息，如果超过 100 个字符，被会截断为 100 个字符。

当然你也可以通过指定参数 进行修改

 
 
 
 
    
  
  
  
  
  1. @pysnooper.snoop(max_variable_length=200） 
    2. 
  
  
  
  
  2. def demo_func(): 
    3. 
  
  
  
  
  3.     ...
    4.

您也可以使用max_variable_length=None它从不截断它们。

 
 
 
 
    
  
  
  
  
  1. @pysnooper.snoop(max_variable_length=None） 
    2. 
  
  
  
  
  2. def demo_func(): 
    3. 
  
  
  
  
  3.     ...
    4.

2.6 支持多线程调试模式

PySnooper 同样支持多线程的调试，通过设置参数 thread_info=True，它就会在日志中打印出是在哪个线程对变量进行的修改。

 
 
 
 
    
  
  
  
  
  1. @pysnooper.snoop(thread_info=True) 
    2. 
  
  
  
  
  2. def demo_func(): 
    3. 
  
  
  
  
  3.     ...
    4.

效果如下

2.7 自定义对象的格式输出

pysnooper.snoop() 函数有一个参数是 custom_repr，它接收一个元组对象。

在这个元组里，你可以指定特定类型的对象以特定格式进行输出。

这边我举个例子。

假如我要跟踪 person 这个 Person 类型的对象，由于它不是常规的 Python 基础类型，PySnooper 是无法正常输出它的信息的。

因此我在 pysnooper.snoop() 函数中设置了 custom_repr 参数，该参数的第一个元素为 Person，第二个元素为 print_persion_obj 函数。

PySnooper 在打印对象的调试信息时，会逐个判断它是否是 Person 类型的对象，若是，就将该对象传入 print_persion_obj 函数中，由该函数来决定如何显示这个对象的信息。

 
 
 
 
    
  
  
  
  
  1. class Person:pass 
    2. 
  
  
  
  
  2. def print_person_obj(obj): 
    3. 
  
  
  
  
  3.     return f"" 
    4. 
  
  
  
  
  4. @pysnooper.snoop(custom_repr=(Person, print_person_obj)) 
    5. 
  
  
  
  
  5. def demo_func(): 
    6. 
  
  
  
  
  6.     ...
    7.

完整的代码如下

 
 
 
 
    
  
  
  
  
  1. import pysnooper 
    2. 
  
  
  
  
  2. class Person:pass 
    3. 
  
  
  
  
  3. def print_person_obj(obj): 
    4. 
  
  
  
  
  4.     return f"" 
    5. 
  
  
  
  
  5. @pysnooper.snoop(custom_repr=(Person, print_person_obj)) 
    6. 
  
  
  
  
  6. def demo_func(): 
    7. 
  
  
  
  
  7.     person = Person() 
    8. 
  
  
  
  
  8.     person.name = "写代码的明哥" 
    9. 
  
  
  
  
  9.     person.age = 27 
    10. 
  
  
  
  
  10.     person.gender = "male" 
    11. 
  
  
  
  
  11.     return person 
    12. 
  
  
  
  
  12. def main(): 
    13. 
  
  
  
  
  13.     profile = demo_func() 
    14. 
  
  
  
  
  14. main()
    15.

运行一下，观察一下效果。

如果你要自定义格式输出的有很多个类型，那么 custom_repr 参数的值可以这么写

 
 
 
 
    
  
  
  
  
  1. @pysnooper.snoop(custom_repr=((Person, print_person_obj), (numpy.ndarray, print_ndarray))) 
    2. 
  
  
  
  
  2. def demo_func():
    3. 
  
  
  
  
  3.      ...
    4.

还有一点我提醒一下，元组的第一个元素可以是类型（如类名Person 或者其他基础类型 list等），也可以是一个判断对象类型的函数。

也就是说，下面三种写法是等价的。

 
 
 
 
    
  
  
  
  
  1. # 【第一种写法】 
    2. 
  
  
  
  
  2. @pysnooper.snoop(custom_repr=(Person, print_persion_obj)) 
    3. 
  
  
  
  
  3. def demo_func(): 
    4. 
  
  
  
  
  4.     ... 
    5. 
  
  
  
  
  5. # 【第二种写法】 
    6. 
  
  
  
  
  6. def is_persion_obj(obj): 
    7. 
  
  
  
  
  7.     return isinstance(obj, Person) 
    8. 
  
  
  
  
  8. @pysnooper.snoop(custom_repr=(is_persion_obj, print_persion_obj)) 
    9. 
  
  
  
  
  9. def demo_func(): 
    10. 
  
  
  
  
  10.     ...  
    11. 
  
  
  
  
  11. # 【第三种写法】 
    12. 
  
  
  
  
  12. @pysnooper.snoop(custom_repr=(lambda obj: isinstance(obj, Person), print_persion_obj)) 
    13. 
  
  
  
  
  13. def demo_func(): 
    14. 
  
  
  
  
  14.     ...
    15.

以上就是明哥今天给大家介绍的一款调试神器（PySnooper） 的详细使用手册，是不是觉得还不错？

如果你还有其他关于调试的技巧，可以留言区分享出来，一起学习一下~

新闻名称：求你了，别再用print调试代码了
网页URL：http://www.shufengxianlan.com/qtweb/news30/358680.html

网站建设、网络推广公司-创新互联，是专注品牌与效果的网站制作，网络营销seo公司；服务项目有等

广告

声明：本网站发布的内容（图片、视频和文字）以用户投稿、用户转载内容为主，如果涉及侵权请尽快告知，我们将会在第一时间删除。文章观点不代表本网站立场，如需处理请联系客服。电话：028-86922220；邮箱：631063699@qq.com。内容未经允许不得转载，或转载时需注明来源： 创新互联

猜你还喜欢下面的内容

企业网站制作知识

同城分类信息

成都云服务器　　 　四川成都展柜定制厂家　　 　成都网站设计　　 　成都工装公司　　 　LED显示屏　　 　一元广告　　 　南充机房托管　　 　成都圣月制冷　　 　网站空间　　 　成都机柜租用　　 　成都网站制作　　 　成都商城app开发　　 　乐山服务器托管　　 　成都网站运维　　 　香港虚拟主机腾讯云　　 　成都西云机房　　 　软文推广公司　　 　企业网站维护　　 　成都网络营销　　 　宣传册设计