工具窗口参考

当您启动调试器会话时,会出现调试工具窗口。使用此窗口可以控制调试器会话、显示和分析程序数据(帧、变量等),并执行各种调试器操作。

这是调试工具窗口的简要概述。有关使用工具窗口的一般说明,请参阅工具窗口

调试工具窗口概述

会话

可用的调试会话分为调试工具窗口顶部的选项卡。

会话选项卡

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

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

标签

调试工具窗口显示每个会话的以下选项卡:

  • Frames:让您在线程的调用堆栈中导航。

  • 变量:列出当前上下文中可用的变量,并让您分析和修改程序状态。

  • 手表:让您管理手表。默认情况下,手表显示在变量选项卡上,以便更有效地使用屏幕空间。如果您有很多手表,请考虑在单独的选项卡中查看它们。

  • 控制台:显示程序输出。

    对于本地会话,该选项卡的工作方式与您在没有附加调试器的情况下仅运行程序时相同。唯一的区别是调试器输出(例如,来自断点的日志消息)被添加到控制台。

    当您附加到进程时,程序输出不会重定向,只有调试器输出显示在调试器控制台中。

显示/隐藏选项卡

  • 单击 布局选项按钮并选择要查看的选项卡。

    布局选项菜单

恢复默认布局

如果您更改了调试工具窗口的布局并且不喜欢新的排列,您可以将其恢复为默认状态。

  • 单击Debug工具窗口布局选项按钮右上角的,然后单击Restore Default Layout

移动标签

您可以根据自己的喜好排列选项卡。您可以将选项卡移动到另一个位置或将一个选项卡与另一个选项卡分组,以便它们在屏幕上共享相同的空间。

  • 将选项卡标题拖动到所需位置。蓝色框表示目的地。

    将选项卡拖到另一个位置

调试工具栏

无论选择哪个选项卡,您始终可以使用窗口左侧的以下工具栏控件:

物品

工具提示和快捷方式

描述

重新开始

重新运行

Ctrl+F5

单击此按钮可停止当前应用程序并再次运行它。

恢复

简历计划

F9

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

暂停

暂停程序

Ctrl+Pause

单击此按钮可暂停程序执行。

停止

停止

Ctrl+F2

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

查看断点

查看断点

Ctrl+Shift+F8

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

静音断点

静音断点

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

当按下调试图标调试器静音断点工具窗口工具栏中的按钮时,项目中的所有断点都被静音,并且它们的图标变为灰色:。静音断点

您可以暂时静音项目中的所有断点以执行程序而无需在断点处停止。

显示选项菜单

设置

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

  • Show Values Inline:选择此选项以启用内联调试功能,该功能允许在编辑器中查看变量值旁边的使用情况。

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

  • Unmute Breakpoints on Session Finish:选择此选项可在调试会话完成后重新启用所有禁用的断点。

  • 显示返回值:选择此选项可在步进时显示当前帧中已执行函数的返回值。

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

    • 所有具有 dunder 名称的变量。

    • function的所有实例。classobjmodule

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

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

    • Synchronously:如果选择了此检查命令,则显示的消息为Collecting data,然后调试器显示变量的值。

    • 异步:如果选择此检查命令,调试器中的变量将单独加载(异步)。在这种情况下,如果加载一个变量需要很长时间,调试器会显示...Loading Value消息,然后才会显示它的值或Loading timed out消息,如果变量太慢的话。注意建议切换到按需模式的警告消息。

    • On demand:如果选择此检查命令,调试器会显示Show Value消息。单击它以启用加载。

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

图标常规 pin 选项卡

引脚选项卡

单击此按钮可固定或取消固定当前选项卡。您可能需要固定一个选项卡以防止它在此窗口中达到最大选项卡数时自动关闭。

步进工具栏

物品

工具提示和快捷方式

描述

显示执行点

显示执行点

Alt+F10

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

跨过去

跨过

F8

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

踏入

踏入

F7

单击此按钮可使调试器单步执行在当前执行点调用的方法。

强行进入

强行进入

Alt+Shift+F7

单击此按钮可让调试器单步执行在当前执行点调用的方法,即使要跳过此方法。

进入我的代码

进入我的代码

Alt+Shift+F7

单击此按钮可跳过进入库源并继续专注于您自己的代码。

走出去

走出去

Shift+F8

单击此按钮可使调试器跳出当前方法,跳到紧随其后执行的行。

运行到光标

运行到光标

Alt+F9

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

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

评估表达式

评估表达式

Alt+F8

点击此按钮即可。评估表达式

最后修改:2021 年 11 月 19 日