PyCharm 2025.2 Help

调试工具窗口

当您 启动调试器会话时, 调试 工具窗口会打开。 使用此窗口 控制调试器会话查看和分析程序数据 (帧、变量等),并执行调试器操作。

默认情况下,当程序遇到断点时, 调试 工具窗口会打开,并且在会话终止时不会隐藏。 要更改此行为,请转到 生成、执行、部署 | 调试器 设置页面  Ctrl+Alt+S 并取消选中 在断点时显示调试窗口 复选框。

调试工具窗口概述
  1. 会话选项卡

  2. 调试器控制台选项卡

  3. 变量监视

  4. 调试器工具栏

会话

可用的调试会话被分隔在 调试 工具窗口顶部的选项卡中。

如果您为特定的运行/调试配置 启用了服务工具窗口 ,那么当您调试这些配置时,调试工具窗口的整个视图将显示在服务工具窗口中。

编辑器中的所有信息,例如 内联变量值和执行点,都会显示在选定的会话选项卡中。 如果您同时运行多个使用相同的调试会话,这一点很重要。

当您关闭一个选项卡时,相应的调试会话会终止。

工具栏

调试器工具栏包含 控制调试器会话单步执行的最常用操作。

调试器工具栏

您可以根据自己的喜好配置工具栏上可用的操作列表。

自定义调试器工具栏

  • 要添加调试操作,请右键单击调试器工具栏,从上下文菜单中选择 添加到调试器工具栏 ,然后从列表中选择所需的操作。

    自定义调试器工具栏 - 添加操作
  • 要添加与调试无直接关系的操作,请右键点击调试器工具栏,然后从上下文菜单中选择 自定义工具栏

    调试器工具栏上下文菜单中的“自定义工具栏”选项

    在打开的对话框中,单击 添加 ,然后选择所需的操作。

调试器工具栏

无论选择了哪个标签页,您始终可以在窗口左侧使用以下工具栏控件:

项目

工具提示和快捷键

描述

重启

重新运行

Ctrl+F5

点击此按钮以停止当前应用程序并再次运行。

恢复

恢复程序

F9

当应用程序暂停时,点击此按钮以恢复程序执行。

暂停

暂停程序

Ctrl+Pause

点击此按钮以暂停程序执行。

停止

停止

Ctrl+F2

点击此按钮,通过标准 shutdown 脚本外部终止当前进程。

点击按钮一次会调用 soft kill ,允许应用程序捕获 SIGINT 事件并执行正常终止(在 Windows 上, Ctrl+C 事件是模拟的)。 按钮被点击一次后,它将被替换为 “Kill Process” 按钮 ,这表示后续点击将导致应用程序被强制终止,例如在 Unix 上会发送 SIGKILL

查看断点

查看断点

Ctrl+Shift+F8

点击此按钮打开 断点 对话框,您可以在其中配置断点行为。

静音断点

静音断点

使用此按钮切换断点状态。

调试工具窗口的工具栏中按下 按钮时,项目中的所有断点将被静音,其图标变为灰色: muted_breakpoint.png

您可以暂时静音项目中的所有断点,以便在不停止于断点的情况下执行程序。

更多

更多

打开包含以下附加操作的菜单:

显示选项菜单

调试器设置

打开包含以下选项的菜单:

  • 在预览标签页中打开文件 :选择此选项 在选择相应帧时在预览标签页中打开文件

  • 在编辑器中显示变量值 :选择此选项以启用 内联调试功能,该功能允许在编辑器中直接在变量使用位置旁边查看其值。

  • 按字母顺序对变量进行排序 :选择此选项以按字母顺序对 变量窗格中的值进行排序。

  • 在会话完成时取消忽略断点 :选择此选项以在调试会话结束后重新启用所有已禁用的断点。

  • 显示返回值 :选择此选项以在单步执行时显示当前框架中已执行函数的返回值。

  • 简化变量视图 :选择此选项以将以下名称包含到 特殊变量 组中:

    • 所有带有双下划线名称的变量。

    • 所有 functionclassobjmodule 的实例。

    • 如果已启动带有 IPython 的调试控制台,则所有 IPython 内部变量。

  • 变量加载策略。 您可以选择以下策略之一:

    • 同步 :如果启用此选项,显示的消息是 Collecting data ,之后调试器会显示变量的值。

    • 异步 :如果启用此选项,调试器中的变量会单独加载(异步)。 在这种情况下,如果加载变量需要很长时间,调试器会显示 ...Loading Value 消息,之后才会显示其值,或者如果变量过于缓慢,则显示 Loading timed out 消息。 注意建议切换到 按需模式的警告消息。

    • 按需 :如果启用此选项,调试器会显示 Show Value 消息。 单击它以启用加载。

    请注意,加载策略的任何更改在您重新运行调试过程后生效。

项目

工具提示和快捷键

描述

重启

重新运行

Ctrl+F5

点击此按钮以停止当前应用程序并再次运行。

恢复

恢复程序

F9

当应用程序暂停时,点击此按钮以恢复程序执行。

暂停

暂停程序

Ctrl+Pause

点击此按钮以暂停程序执行。

停止

停止

Ctrl+F2

点击此按钮通过标准 shutdown 脚本外部终止当前进程。

查看断点

查看断点

Ctrl+Shift+F8

点击此按钮打开 断点 对话框,您可以在其中配置断点行为。

静音断点

静音断点

使用此按钮切换断点状态。

调试工具窗口的工具栏中按下 按钮时,项目中的所有断点将被静音,其图标变为灰色: muted_breakpoint.png

您可以暂时静音项目中的所有断点,以便在不停止于断点的情况下执行程序。

显示选项菜单

设置

点击此按钮打开包含以下选项的菜单:

  • 内联显示值 :选择此选项以启用 内联调试功能,该功能允许在编辑器中直接在变量使用位置旁边查看其值。

  • 按字母顺序排序值 :选择此选项以按字母顺序对 变量窗格中的值进行排序。

  • 会话结束时取消静音断点 :选择此选项以在调试会话结束后重新启用所有已禁用的断点。

  • 显示返回值 :选择此选项以在单步执行时显示当前框架中已执行函数的返回值。

  • 简化变量视图 :选择此选项将以下名称包含到 特殊变量 组中:

    • 所有带有双下划线名称的变量。

    • 所有 functionclassobjmodule 的实例。

    • 如果已启动带有 IPython 的调试控制台,则所有 IPython 内部变量。

  • 变量加载策略。 您可以选择以下策略之一:

    • 同步 :如果启用此选项,显示的消息为 Collecting data ,之后调试器会显示变量的值。

    • 异步 :如果启用此选项,调试器中的变量会单独(异步)加载。 在这种情况下,如果加载变量需要很长时间,调试器会显示 ...Loading Value 消息,之后才会显示其值,或者如果变量过于缓慢,则显示 Loading timed out 消息。 注意建议切换到 按需模式的警告消息。

    • 按需 :如果启用此选项,调试器会显示 Show Value 消息。 单击它以启用加载。

    请注意,加载策略的任何更改在您重新运行调试过程后生效。

固定选项卡页

点击此按钮以固定或取消固定当前选项卡。 当窗口中的标签页达到最大数量时,您可能需要将一个标签页固定,防止其自动关闭。

单步执行工具栏

项目

工具提示和快捷键

描述

显示执行点

显示执行点

Alt+F10

点击此按钮以突出显示编辑器中的当前执行点,并在 窗口 窗格中显示相应的堆栈帧。

逐步跳过

单步跳过

F8

点击此按钮以执行程序,直到当前方法或文件中的下一行,跳过当前执行点引用的方法(如果有)。 如果当前行是方法中的最后一行,执行步骤将跳转到该方法之后执行的行。

强制步过

强制单步跳过

Alt+Shift+F8

单击此按钮,即使方法内部有断点,调试器也会跳过该方法。

逐步进入

单步进入

F7

点击此按钮以使调试器进入当前执行点调用的方法。

智能逐步进入

智能单步进入

Shift+F7

如果当前行包含多个嵌套调用,PyCharm 允许您选择一个调用进行单步进入。 请考虑以下代码行:

Console.WriteLine(Foo(Bar("input") + Baz("input")));

该行包含多个调用,如果您使用 单步进入 ,调试器将首先进入 Bar() 的实现,然后进入 Baz() 的实现,依此类推。

如果您希望选择要进入的调用,例如 Bar() ,您可以使用 智能单步进入 智能单步进入 Shift+F7

PyCharm:智能单步进入 - 进入选定调用

当您选择要进入的函数时,调试器会将执行指针设置为所选函数的第一条语句。

选择器还会显示哪些调用已经被执行,并允许您再次执行这些调用。

当您在包含多个方法调用的行中调用 单步进入 F7 时,可以启用“智能进入”行为。 为此,请在 构建、执行、部署 | 调试器 | 单步调试 设置页面 Ctrl+Alt+S 中选择 始终使用智能步入

逐步进入我的代码

单步进入我的代码

Alt+Shift+F7

点击此按钮以跳过进入库源代码,并专注于您的代码。

逐步退出

单步退出

Shift+F8

点击此按钮可使调试器退出当前方法,并跳至其后执行的行。

运行到光标处

运行至光标

Alt+F9

点击此按钮以恢复程序执行,并在执行点到达编辑器中当前光标位置的行时暂停。 不需要断点。 实际上,在光标处为当前行设置了一个临时断点,一旦程序执行暂停,该断点就会被移除。 因此,如果文本光标位于已执行的行,程序将只是恢复执行,因为无法回滚到先前的断点。 此操作在您深入方法序列且需要一次退出多个方法时特别有用。

如果在应该执行的行上设置了断点,在到达指定行之前,调试器会在遇到的第一个断点处暂停。

强制运行到光标

运行到光标不停顿

Ctrl+Alt+F9

如果当前执行点和目标语句之间有断点,您可以使用 运行到光标不停顿 运行到光标不停顿 命令 Ctrl+Alt+F9 强制调试器跳过这些断点。

计算表达式

计算表达式

Alt+F8

点击此按钮可 评估表达式

项目

工具提示和快捷键

描述

显示执行点

显示执行点

Alt+F10

点击此按钮以突出显示编辑器中的当前执行点,并在 窗口 窗格中显示相应的堆栈帧。

逐步跳过

单步跳过

F8

点击此按钮以执行程序,直到当前方法或文件中的下一行,跳过当前执行点引用的方法(如果有)。 如果当前行是方法中的最后一行,执行步骤将跳转到该方法之后执行的行。

逐步进入

单步进入

F7

点击此按钮以使调试器进入当前执行点调用的方法。

强制单步执行

强制单步进入

Alt+Shift+F7

点击此按钮以使调试器进入当前执行点中调用的方法,即使该方法将被跳过。

逐步进入我的代码

单步进入我的代码

Alt+Shift+F7

点击此按钮以跳过进入库源代码,并专注于您的代码。

逐步退出

单步退出

Shift+F8

点击此按钮可使调试器退出当前方法,并跳至其后执行的行。

运行到光标处

运行至光标

Alt+F9

点击此按钮以继续程序执行,并暂停直到执行点到达编辑器中当前光标位置的行。 不需要断点。 实际上,在光标处为当前行设置了一个临时断点,一旦程序执行暂停,该断点就会被移除。 因此,如果文本光标位于已执行的行,程序将只是恢复执行,因为无法回滚到先前的断点。 此操作在您深入方法序列且需要一次退出多个方法时特别有用。

如果在应该执行的行上设置了断点,在到达指定行之前,调试器会在遇到的第一个断点处暂停。

计算表达式

计算表达式

Alt+F8

点击此按钮可 评估表达式

布局设置

显示/隐藏选项卡

  1. 调试 工具窗口的右上角,单击 布局设置

    布局设置
  2. 在打开的上下文菜单中,选择需要显示或隐藏的选项卡(窗格)。 所选窗格和选项卡会以选中标记表示。

显示选项卡标签

使用此选项可显示调试器选项卡和窗格的名称。

  1. 调试 工具窗口的右上角,单击 布局设置

  2. 在打开的上下文菜单中,选择 显示选项卡标签

    显示选项卡标签

恢复默认布局

如果您更改了 调试 工具窗口的布局,可以将其恢复为默认状态。

  1. 调试 工具窗口的右上角,单击 布局设置

  2. 在打开的上下文菜单中,选择 恢复默认布局

    恢复默认布局
最后修改日期: 2025年 9月 26日