Debian上Python代码如何调试

在Debian环境下调试Python代码，其实方法有很多，关键在于找到最适合你当前场景的那一款。下面系统梳理几种主流方案，从最基础的到最专业的，逐一拆解。

一、最朴实的武器：print()

别看它简单，print() 绝对是新手老手都会用的调试利器。在代码的关键位置插入一行输出，把变量值、执行路径打印到终端，直接就能看出问题出在哪。优点是零门槛、零依赖，缺点是调试完成后需要手动删除或注释掉这些打印语句，否则会污染代码。对于快速验证逻辑或排查简单错误，它依然高效。

二、Python自带的调试器：pdb

如果你觉得print()太原始，那pdb就是官方给你准备的“手术刀”。它内置于Python标准库中，无需额外安装。用法很简单：在代码里导入pdb，然后在你想停下来观察的地方加上一行pdb.set_trace()。比如这样：

import pdb

def my_function():
    x = 1
    y = 2
    pdb.set_trace()  # 程序执行到这里会暂停
    z = x + y
    return z

my_function()

当代码运行到pdb.set_trace()时，会进入交互式调试模式。常用命令只有几个：

• n（next）：一行一行往下走
• c（continue）：直接执行到下一个断点
• s（step）：跳进函数或方法内部
• q（quit）：退出调试器

这些组合起来，基本能应对绝大多数单步追踪的需求。不过pdb是命令行界面，对新手可能不太友好，但一旦习惯，效率非常高。

三、图形化调试：IDE自带工具

如果你更习惯可视化操作，那IDE或代码编辑器的调试功能就是首选。比如PyCharm、Visual Studio Code，都内置了非常成熟的调试器。你可以直接在代码行号旁边点击设置断点，然后通过按钮或快捷键控制执行流程，实时查看变量值、调用堆栈、表达式求值等。这种方式的优势在于：不用记忆命令，所有信息一目了然，特别适合处理复杂逻辑或大型项目。

在Debian上无论是用PyCharm社区版还是VS Code，配置都非常简单，安装Python扩展后几乎开箱即用。而且图形化调试器通常还支持条件断点、监听变量、多线程调试等高级功能，可以说是“一把梭”的解决方案。

四、持久化记录：logging模块

以上方法都适合交互式调试，但如果你需要记录程序运行过程中的关键信息，或者调试运行在服务器上的后台服务，日志记录才是王道。Python的logging模块非常灵活，可以控制输出级别、格式、目的地（文件、终端、网络等）。举个最简单的例子：

import logging

logging.basicConfig(filename='debug.log', level=logging.DEBUG)

def my_function():
    x = 1
    y = 2
    logging.debug(f'x: {x}, y: {y}')
    z = x + y
    return z

my_function()

运行后，所有DEBUG级别的日志都会被写入到debug.log文件里。你可以随时查看，排查问题。相比print()，日志记录的优势是：可分级、可持久化、不影响终端输出，更符合工程化规范。而且logging模块在生产环境中也能用，只需调整日志级别即可。

总结一下

没有哪一种调试方法能包打天下。简单场景用print()，需要逐行追踪用pdb，追求效率用IDE图形化工具，生产环境或需要长期记录则用logging。实际开发中，往往是几种方法组合使用。关键在于理解每种工具的核心能力，然后根据上下文灵活切换。这才是专业调试的常态。