Debian Python如何调试代码

Debian系统下调试Python代码的常用方法

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

pdb是Python标准库中的交互式调试器，无需额外安装，适合简单脚本调试。

• 设置断点：在需要暂停的代码行前添加import pdb; pdb.set_trace()，程序运行到该行时会进入调试模式。
• 常用命令：
  • l（list）：显示当前代码行周围的上下文；
  • n（next）：执行下一行代码（不进入函数）；
  • s（step）：执行下一行代码（进入函数）；
  • c（continue）：继续执行直到下一个断点或程序结束；
  • p 变量名（print）：打印变量的值；
  • q（quit）：退出调试模式。

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

ipdb是pdb的增强版，提供语法高亮、自动补全等功能，提升调试体验。

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

3. 使用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服务器上，可通过ptvsd模块实现远程调试：

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