Python调试利器PySnooper：无需断点，一行代码实现全量日志追踪

沿途有光

发布时间：2026-10-14| 4人浏览过

原创

PySnooper是一款GitHub热门Python开源调试工具，无需配置断点即可通过装饰器实现函数执行全量日志追踪。本文详解其安装方法、核心用法及局部代码块追踪技巧，展示如何快速获取变量变化与执行路径，是处理复杂逻辑与大型项目调试的高效替代方案。

许多程序员在调试代码时习惯使用 print 语句。当代码量较少时，这种方法尚可接受；然而，面对大型项目时，大量杂乱的 print 输出往往会让调试过程变得极其繁琐和令人头疼。

本文推荐一个在 GitHub 上备受关注的开源项目：PySnooper。该项目发布首日即获得超过 2000 个 Star，迅速登顶 GitHub 日榜首位，目前累计 Star 数已接近 15k。这充分证明了它是 Python 开发者青睐的实用工具。建议收藏以便后续学习，如果喜欢请点赞支持，文末设有技术交流区供深入讨论。

项目地址：https://github.com/cool-RR/PySnooper

PySnooper 是什么？

当你的 Python 代码未按预期运行时，你可能需要绞尽脑汁排查错误。虽然成熟的断点调试器是理想选择，但有时你并不想花费时间去配置复杂的调试环境。

你希望明确知道哪些代码行正常执行，哪些出现了异常。据观察，大多数开发者会在可疑位置插入 print 语句来辅助排查。

PySnooper 的作用与此类似，但更加便捷。你无需小心翼翼地添加 print 语句，只需在需要调试的函数上应用一个装饰器。随后，你将获得该函数的详细日志，包括具体执行了哪些代码行、执行时间以及局部变量何时被修改。

为什么 PySnooper 能从众多智能调试工具中脱颖而出？

关键在于它无需任何复杂设置即可直接应用于混乱且庞大的企业级代码库。只需像示例那样启用装饰器，并将输出重定向至专用日志文件，通过指定第一个参数来定义日志文件路径即可。

注意：如果无法访问标准错误输出（stderr），可将输出重定向到指定文件，例如：@pysnooper.snoop('/my/log/file.log')

使用范例

以下示例演示了一个将数字转换为二进制数的函数。


import pysnooper

@pysnooper.snoop()
def number_to_bits(number):
    if number:
        bits = []
        while number:
            number, remainder = divmod(number, 2)
            bits.insert(0, remainder)
        return bits
    else:
        return [0]

number_to_bits(6)

输出结果

Starting var:.. number = 6 21:14:32.099769 call 3 @pysnooper.snoop() 21:14:32.099769 line 5 if number: 21:14:32.099769 line 6 bits = [] New var:....... bits = [] 21:14:32.099769 line 7 while number: 21:14:32.099769 line 8 number, remainder = divmod(number, 2) New var:....... remainder = 0 Modified var:.. number = 3 21:14:32.099769 line 9 bits.insert(0, remainder) Modified var:.. bits = [0] 21:14:32.099769 line 7 while number: 21:14:32.099769 line 8 number, remainder = divmod(number, 2) Modified var:.. number = 1 Modified var:.. remainder = 1 21:14:32.099769 line 9 bits.insert(0, remainder) Modified var:.. bits = [1, 0] 21:14:32.099769 line 7 while number: 21:14:32.099769 line 8 number, remainder = divmod(number, 2) Modified var:.. number = 0 21:14:32.099769 line 9 bits.insert(0, remainder) Modified var:.. bits = [1, 1, 0] 21:14:32.099769 line 7 while number: 21:14:32.099769 line 10 return bits 21:14:32.099769 return 10 return bits

如果你只想追踪函数中的特定部分而非整个函数，可以使用 with 块包裹目标代码段，如下所示：


import pysnooper
import random

def foo():
    lst = []
    for i in range(10):
        lst.append(random.randrange(1, 1000))

    with pysnooper.snoop():
        lower = min(lst)
        upper = max(lst)
        mid = (lower + upper) / 2
        print(lower, mid, upper)

foo()

输出结果

New var:....... i = 9 New var:....... lst = [681, 267, 74, 832, 284, 678, ...] 09:37:35.881721 line 10 lower = min(lst) New var:....... lower = 74 09:37:35.882137 line 11 upper = max(lst) New var:....... upper = 832 09:37:35.882304 line 12 mid = (lower + upper) / 2 74 453.0 832 New var:....... mid = 453.0 09:37:35.882486 line 13 print(lower, mid, upper) Elapsed time: 00:00:00.000344