PyCharm 2025.1 Help

调试

调试会话中,您会启动带有调试器附加的程序。 调试器的目的是干扰程序执行,并向您提供后台发生情况的信息。 这有助于检测和修复程序中的错误。

如果您是调试新手,请尝试 使用 PyCharm 进行调试 教程。

配置调试选项

  1. 设置 | 构建、执行、部署 | 调试器 中配置常见的 调试属性和行为

    如果您是调试新手,开箱即用的配置将适合您。 每个调试器功能主题提供参考,并在适用时解释相关设置。 如果您是高级用户并在寻找某些特定属性,请参阅 Debugger 参考部分。

  2. 构建、执行和部署 部分下,选择 Python 调试器 ,并配置 Python 调试器选项。

  3. 项目 | Python Interpreter 部分下,配置可能需要用于某些调试配置的 Python 包

  4. 如果您打算使用自定义的 运行/调试配置 ,请定义一个。 如果需要将一些参数传递给程序或在启动前执行一些特殊活动,这是必须的。 有关设置运行/调试配置的更多信息,请参阅 运行/调试配置 部分。 大多数情况下,您不需要这个来调试不期望参数或没有任何特殊要求的简单程序。

一般调试程序

没有适用于所有应用程序的万能调试程序。 根据实际需求,您可能需要以不同的顺序使用不同的操作。 此主题提供了一般指南,代表了典型的调试步骤。 有关如何及何时使用特定功能的详细信息已在相应主题中提供。

  1. 定义程序需要停止的位置。 这是使用 断点完成的。 断点 是特殊标记,表示调试器需要介入并冻结程序状态的位置和条件。 由调试器冻结的程序称为 suspended

    使用 手动挂起程序替代断点的另一种方法,但是这种方法对调试器功能施加了一些限制,并且不能精确控制何时挂起程序。

  2. 以调试模式运行您的程序

    只需右键点击编辑器中的任意一行,然后从上下文菜单中选择 调试 <FileName> 命令。

  3. 程序暂停后,使用调试器来 获取有关程序状态的信息以及它在运行过程中如何变化。

    调试器为您提供有关变量值、线程当前状态、当前堆中对象分解等信息。 它还允许您通过抛出异常(例如,检查它们如何处理)或在程序执行过程中间运行任意代码,在各种条件下测试您的程序。

    虽然这些工具让您可以在特定时刻检查程序状态,但 stepping功能为您提供了对程序逐步执行的控制。 通过结合这些工具,您可以推断出错误的来源,并测试程序的鲁棒性。

最后修改日期: 2025年 4月 23日