Ubuntu上如何调试Python代码

首页

编程语言

Ubuntu上如何调试Python代码

热心网友

转载

2026-04-17

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

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

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

Ubuntu上如何调试Python代码

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调试

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

启动VS Code，进入扩展市场，搜索并安装微软官方提供的“Python”扩展。
点击侧边栏的“运行和调试”图标（或按Ctrl+Shift+D），然后点击“创建一个launch.json文件”。

VS Code会根据你的项目类型生成调试配置文件。一个用于调试当前打开文件的常见配置示例如下：

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

在代码行号旁点击设置断点。
按下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的方法，将是你提升开发效率和代码质量的关键一步。

来源:https://www.yisu.com/ask/2446558.html

免责声明：游乐网为非赢利性网站，所展示的游戏/软件/文章内容均来自于互联网或第三方用户上传分享，版权归原作者所有，本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容，请联系youleyoucom@outlook.com。

上一篇：Ubuntu如何配置PHP-FPM内存限制下一篇：golang如何实现网络连接复用_golang网络连接复用实现攻略