PyCharm 2026.2 Help

调试

调试会话 期间,您在附加调试器的情况下启动程序。 调试器的目的在于干预程序的执行,并向您提供幕后发生了什么的信息。 这有助于在程序中定位并修复错误。

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

调试器实现名册

PyCharm 使用 debugpy 作为 Python 3.9 或更高版本的默认调试器,适用于本地和 WSL 解释器。 它基于 Debug Adapter Protocol ,兼容标准 Python 调试工作流程及外部调试适配器。

要切换到 pydevd ,请执行以下任一操作:

  • 转到 设置 | Python | 调试器。 在 调试器模式 字段中选择所需选项。

    调试器模式设置
  • 将鼠标悬停在 调试 工具窗口上,并使用右上角的选择器。

    调试器模式

    配置调试选项

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

    2. 设置 | Python 部分下,选择 调试器 ,并配置调试器选项。

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

    4. 如果您打算使用自定义配置,请定义一个 运行/调试配置。 如果您需要向程序传递参数,或在启动前执行某些特殊操作,则需要这样做。 有关设置运行/调试配置的更多信息,请参阅 运行/调试配置 部分。 对于不需要参数且没有特殊要求的简单程序,大多数情况下无需这样做即可进行调试。

    通用调试流程

    调试应用没有放之四海而皆准的流程。 根据实际需求,您可能需要以不同顺序执行不同操作。 本主题提供通用指南,涵盖典型的调试步骤。 关于何时以及如何使用特定功能的详细信息,请参阅相应主题。

    1. 确定程序需要停止的位置。 这可以通过使用 断点 来完成。 断点 是特殊标记,用于表示调试器需要介入并冻结程序状态的位置和条件。 被调试器冻结的程序称为 挂起

      使用断点的替代方案是在任意时刻 手动挂起程序,但这种方法对调试器功能有所限制,并且无法精确控制何时挂起程序。

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

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

    3. 程序被挂起后,使用调试器 获取有关程序状态的信息 ,以及其在运行期间如何变化。

      调试器会向您提供变量值、线程的当前状态、当前堆中对象的明细等信息。 它还允许您通过抛出异常(例如,用于检查其处理方式),或在程序执行过程中直接运行任意代码,来在各种条件下测试程序。

      这些工具可以让您在特定时刻检查程序状态,而 步进 功能则让您能够控制程序的逐步执行。 通过组合使用这些工具,您可以推断出错误来源,并测试程序的健壮性。

    2026年 7月 14日