Python 调试基础

Python 调试的核心目标是定位和修复代码中的错误。常见的调试方法包括使用内置工具、第三方库和 IDE 功能。

打印调试信息
使用 print() 输出变量值或执行路径是最简单的调试方法。适合快速检查代码片段的状态，但可能污染代码结构。

断言调试
通过 assert 语句验证条件是否满足。如果条件为假，程序会抛出 AssertionError。适合在开发阶段验证假设。

assert x > 0, "x 必须为正数"

使用 pdb 调试器

Python 自带 pdb 模块，支持交互式调试。以下是常见用法：

启动 pdb
在代码中插入 import pdb; pdb.set_trace()，程序运行到该行时会进入调试模式。

常用命令

• l 或 list: 显示当前代码上下文
• n 或 next: 执行下一行
• s 或 step: 进入函数调用
• c 或 continue: 继续执行到下一个断点
• p <变量名>: 打印变量值
• q: 退出调试

高级调试工具

logging 模块
替代 print()，支持分级输出和日志文件记录。配置灵活，适合长期运行的程序。

import logging
logging.basicConfig(level=logging.DEBUG)
logging.debug("调试信息")

第三方库

• ipdb: 增强版 pdb，支持自动补全和语法高亮
• pudb: 基于终端的可视化调试器
• PyCharm/VSCode 调试器: 图形化界面支持断点和变量监控

异常处理调试

通过捕获异常获取错误上下文，结合 traceback 模块定位问题根源。

import traceback

try:
    risky_operation()
except Exception as e:
    traceback.print_exc()

性能调试技巧

timeit 模块
测量代码段执行时间，识别性能瓶颈。

import timeit
timeit.timeit('"-".join(str(n) for n in range(100))', number=10000)

cProfile 模块
分析函数调用时间和频率，生成详细性能报告。

import cProfile
cProfile.run('my_function()')

调试最佳实践

• 最小化复现问题：提取能重现错误的最小代码片段
• 二分法排查：通过注释代码快速定位问题区域
• 单元测试：编写测试用例验证边界条件和异常场景
• 版本控制：利用 git 二分查找引入错误的提交

常见错误类型分析

语法错误
通过 IDE 或 pyflakes 等工具在运行前检测。错误信息通常包含行号和具体问题描述。

逻辑错误
需要逐步验证变量状态和程序流程。使用断言和测试用例预防。

运行时错误
如 KeyError 或 TypeError，需检查输入数据和处理逻辑的健壮性。