Debian Python如何调试代码

在Debian系统上调试Python代码，说到底就是一件需要耐心和正确工具的事情。今天咱们就围绕几个常用方法展开，从最基础的pdb一路聊到远程调试，希望能覆盖你日常开发中的绝大多数场景。

1. 使用内置pdb模块（基础调试）

知名的基础调试工具——pdb。说来也巧，Python自带的pdb模块就是最基础也最直接的调试利器了。它随标准库一起安装，无需额外折腾，对付简单的脚本调试完全够用。

• 设置断点：在需要暂停的代码行前加上 import pdb; pdb.set_trace()，程序运行到这里便会自动进入交互式调试界面。
• 常用命令：
  • l（list）：展示当前代码行附近的上下文；
  • n（next）：执行下一行代码，但不进入函数内部；
  • s（step）：执行下一行代码，若遇到函数则进入其中；
  • c（continue）：继续运行，直到遇到下一个断点或程序结束；
  • p 变量名（print）：打印指定变量的值；
  • q（quit）：退出调试模式。

2. 使用ipdb增强调试（推荐）

如果觉得pdb界面太过朴素，ipdb会是更好的选择。它本质上还是pdb，但额外带来了语法高亮和自动补全功能，调试体验会舒服很多。

• 安装：通过pip安装 pip install ipdb 即可。
• 使用方法：把代码中的 import pdb; pdb.set_trace() 替换为 import ipdb; ipdb.set_trace()，运行脚本后就能进入增强版调试模式，命令与pdb保持一致。

3. 使用IDE集成调试（图形化操作）

对于习惯图形化操作的朋友来说，IDE集成调试绝对是效率最高的方式。这里重点说两个主流工具。

PyCharm

• 设置断点：在代码行左侧点击，出现红色圆点即为断点。
• 启动调试：点击顶部菜单栏的 Run → Debug（或按Shift+F9），程序会在断点处暂停。
• 调试功能：通过调试面板可以随时查看变量值、调用堆栈，支持单步执行（F7/F8）、条件断点（右键断点设置条件）等操作。

Visual Studio Code（VS Code）

• 安装扩展：在扩展商店搜索“Python”并安装Microsoft官方扩展。
• 配置调试：点击左侧活动栏的调试图标，选择“Python File”，设置断点后点击绿色三角形即可启动调试。
• 调试功能：支持变量监视、表达式求值，远程调试则需要配置launch.json文件。

4. 使用日志记录（非交互式调试）

当程序运行在长期任务或生产环境中时，交互式调试往往不太现实。这时候logging模块就派上用场了——通过记录程序执行过程中的关键信息，可以事后复盘问题。

• 基本配置：在代码开头添加 import logging; logging.basicConfig(level=logging.DEBUG, format='%(asctime)s - %(levelname)s - %(message)s')。
• 记录日志：在关键位置添加 logging.debug(f"变量值: {variable}")，运行后会在控制台或文件里输出时间、日志级别和自定义信息。

5. 使用assert语句（快速验证假设）

调试阶段往往需要快速验证某个逻辑假设是否成立。这时assert语句就是最轻量的手段——当条件为False时，程序立刻抛出AssertionError并终止，方便你快速定位错误。

• 示例：assert x > 0, "x必须为正数"，一旦x ≤ 0，程序就会终止并显示错误信息。

6. 调试异步代码

异步代码（如使用asyncio）的调试稍微有些特别，不过也不复杂。

• pdb/ipdb：直接在异步函数里设置断点，遇到await关键字时，系统会进入异步调用内部。
• aiomonitor：可以实时检查事件循环和活动任务，安装后运行 aiomonitor start 即可开始监控。

7. 远程调试（适用于远程服务器）

如果代码运行在远程Debian服务器上，本地IDE无法直接连接时，可以借助ptvsd模块实现远程调试。

• 安装ptvsd：pip install ptvsd。
• 配置代码：在代码中添加 ptvsd.enable_attach(address=('0.0.0.0', 5678)) 和 ptvsd.wait_for_attach()，启动程序后会等待本地调试器连接。
• 本地连接：在PyCharm或VS Code中配置远程调试，输入服务器IP和端口即可建立连接。