Ubuntu上如何调试Python代码

在Ubuntu上调试Python代码：从基础到进阶的实用指南

调试是每位Python开发者必须掌握的核心技能，它能将代码从“勉强运行”提升到“稳定可靠”的专业水准。在Ubuntu这一流行的Linux发行版上，Python调试工具链非常完善，涵盖了从命令行工具到集成开发环境的多种选择。熟练掌握这些工具，能显著提升你定位和修复Bug的效率，让开发工作更加顺畅。

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

1. 内置利器：pdb（Python Debugger）

作为Python调试的基石，pdb是Python标准库自带的调试器。它无需任何额外安装，即可通过命令行或代码内嵌的方式启动，是真正“开箱即用”的调试解决方案，非常适合快速排查问题。

通过命令行使用pdb

此方法适用于需要从头跟踪脚本完整执行流程的场景。在Ubuntu终端中，只需输入以下命令：

python -m pdb your_script.py

命令执行后，调试器会在脚本的第一行代码前暂停。此时，你可以使用一系列核心命令来控制执行，例如：n（执行下一行）、s（步入函数内部）、c（继续运行直到下一个断点）以及p（打印变量值）。

在代码中插入断点

当你已经将问题范围缩小到特定代码区域时，直接在源代码中设置断点是最直接的方法。只需在目标行插入：

import pdb; pdb.set_trace()

当程序执行到该行时，会自动中断并进入pdb交互式调试会话。这种方式能实现精准定位，是动态调试的常用技巧。

2. 体验升级：ipdb

如果你觉得原生pdb的交互界面过于简陋，那么ipdb是一个绝佳的增强替代品。它在完全兼容pdb所有功能的基础上，引入了IPython的强大特性，如语法高亮、自动补全、更好的回溯信息显示等，极大改善了调试体验。

安装ipdb

在Ubuntu上，通过pip可以轻松完成安装：

pip install ipdb

使用ipdb

其使用方式与pdb高度一致，仅需修改导入的模块名：

import ipdb; ipdb.set_trace()

对于习惯在终端进行开发的工程师而言，ipdb带来的效率提升是立竿见影的。

3. 重型武器：PyCharm

面对大型、复杂的Python项目，一个功能全面的集成开发环境（IDE）至关重要。JetBrains出品的PyCharm提供了业界顶尖的图形化调试器，将代码编写、运行和调试无缝整合，是专业开发者的首选工具之一。

安装PyCharm

访问JetBrains官网，下载适用于Ubuntu的.tar.gz安装包。解压后，进入bin目录，执行./pycharm.sh脚本即可启动安装向导或直接运行。

使用PyCharm调试

1. 在PyCharm中打开或导入你的Python项目。
2. 在代码编辑区左侧的行号区域单击，即可轻松设置或取消断点（显示为红色圆点）。
3. 点击工具栏上的“调试”按钮（绿色虫子图标）来以调试模式运行项目。
4. 程序会在断点处暂停。此时，你可以利用调试工具窗口查看变量值、监视表达式、分析调用堆栈，并通过步进（Step Over/Into/Out）按钮精细控制代码执行流程。

图形化界面将所有调试信息直观呈现，避免了记忆复杂命令的负担，尤其适合进行复杂的逻辑梳理和问题深挖。

4. 轻量之选：VS Code

如果你偏好一款轻量、快速且可高度扩展的代码编辑器，那么Visual Studio Code（VS Code）配合其强大的Python插件，完全可以提供媲美完整IDE的调试体验，成为在Ubuntu上调试Python的又一利器。

安装VS Code

从VS Code官网下载.deb安装包，在终端使用以下命令安装：sudo dpkg -i code_*.deb。也可以通过Snap商店直接安装。

配置VS Code调试Python

1. 启动VS Code，进入扩展市场，搜索并安装微软官方提供的“Python”扩展。
2. 点击侧边栏的“运行和调试”图标（或按Ctrl+Shift+D），然后点击“创建一个launch.json文件”。
3. VS Code会根据你的项目类型生成调试配置文件。一个用于调试当前打开文件的常见配置示例如下：

   {
       "version": "0.2.0",
       "configurations": [{
           "name": "Python: 调试当前文件",
           "type": "python",
           "request": "launch",
           "program": "${file}",
           "console": "integratedTerminal"
       }]
   }

4. 在代码行号旁点击设置断点。
5. 按下F5键，调试会话立即启动。你可以利用侧边栏查看变量、调用堆栈，并在集成终端中进行交互操作。

VS Code的优势在于其极简的设计和强大的扩展性，一次配置即可实现高效的一键式调试流程。

5. 追踪足迹：logging模块

并非所有问题都需要让程序停止。很多时候，我们需要在不干扰程序正常运行的情况下，持续记录其运行状态和关键数据。Python内置的logging模块正是为此设计的强大工具，它允许你输出不同级别的日志信息，如同在代码执行路径上留下清晰的足迹。

使用logging

import logging
logging.basicConfig(level=logging.DEBUG, format='%(asctime)s - %(levelname)s - %(message)s')
logging.debug('这是一条调试信息，用于追踪变量值。')
logging.info('程序正常执行到此处。')
logging.warning('某个参数可能超出预期范围。')

通过灵活设置日志级别（DEBUG, INFO, WARNING, ERROR, CRITICAL），你可以在开发阶段输出详尽信息以便排查，而在生产环境中只记录错误和警告，实现灵活的日志管理策略。

6. 即时检查：assert语句

在开发过程中，我们常常对代码逻辑有一些基本假设。assert（断言）语句允许你将这种假设明确地写入代码，作为一种轻量级的即时检查机制，确保程序状态符合预期。

使用assert

def calculate_average(scores):
    assert isinstance(scores, list), "输入必须是一个列表"
    assert len(scores) > 0, "分数列表不能为空"
    return sum(scores) / len(scores)

当assert后面的条件表达式求值为False时，程序会立即抛出AssertionError并终止，同时输出你自定义的错误信息。这是一种有效的防御性编程手段，有助于在开发早期捕获逻辑错误。

总结

在Ubuntu系统中进行Python代码调试，拥有一套从简到繁、从命令行到图形界面的完整工具箱。合理选择工具能事半功倍：

• pdb 与 ipdb：作为命令行调试的基石，它们轻便快捷，适合快速验证想法、调试小型脚本或服务器环境下的问题排查。
• PyCharm 与 VS Code：这两款现代开发工具提供了强大的图形化调试界面，支持复杂的断点管理、变量监控和数据可视化，是进行大型项目开发和深度调试的理想选择。
• logging 与 assert：它们是代码内在的“诊断系统”和“安全网”。logging用于持续监控和记录，assert用于验证关键假设，两者结合能极大增强代码的健壮性和可维护性。

实际开发中，最佳实践往往是混合使用这些技术。例如，先用logging输出日志定位问题大致范围，再用PyCharm或ipdb进行交互式单步调试以查明根本原因。掌握这些在Ubuntu上调试Python的方法，将是你提升开发效率和代码质量的关键一步。