PyCharm 2025.3 Help

调试工具窗口

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

默认情况下,当程序触发断点时,会打开 调试 工具窗口;会话终止时不会将其隐藏。 要更改此行为,请转到 构建、执行、部署 | 调试器 设置页面  Ctrl+Alt+S 并清除 在断点处显示调试窗口 复选框。

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

  2. 调试器控制台 选项卡

  3. 变量监视

  4. 调试器工具栏

会话

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

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

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

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

工具栏

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

调试器工具栏

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

自定义调试器工具栏

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

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

    调试器工具栏的上下文菜单中的 'Customize toolbar' 选项

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

调试器工具栏

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

项目

工具提示和快捷键

说明

重新启动

重新运行

Ctrl+F5

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

继续

继续程序

F9

应用暂停时,点击此按钮可继续程序执行。

暂停

暂停程序

Ctrl+Pause

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

停止

停止

Ctrl+F2

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

点击该按钮一次会调用 软终止 ,允许应用捕获 SIGINT 事件并执行优雅终止(在 Windows 上会模拟 Ctrl+C 事件)。 首次点击该按钮后,它会被 Kill Process 按钮 替换,表示后续点击将导致强制终止应用;例如,在 Unix 上会发送 SIGKILL

查看断点

查看断点

Ctrl+Shift+F8

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

静音断点

静音断点

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

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

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

更多

更多

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

显示选项菜单

调试器设置

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

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

  • 在编辑器中显示变量值 :选择此选项可启用 内联调试 功能,使您能够在编辑器中紧邻其用法处查看变量值。

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

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

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

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

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

    • 所有 functionclassobjmodule 的实例。

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

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

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

    • 异步 :启用此选项时,调试器中的变量将分别(异步)加载。 在这种情况下,如果加载某个变量耗时较长,调试器会显示 ...Loading Value 消息,之后才显示其值;如果该变量过慢,则显示 Loading timed out 消息。 请注意提示您切换到 按需 模式的警告消息。

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

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

项目

工具提示和快捷键

说明

重新启动

重新运行

Ctrl+F5

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

继续

继续程序

F9

应用暂停时,点击此按钮可继续程序执行。

暂停

暂停程序

Ctrl+Pause

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

停止

停止

Ctrl+F2

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

查看断点

查看断点

Ctrl+Shift+F8

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

静音断点

静音断点

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

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

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

显示选项菜单

设置

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

  • 内联显示值 :选择此选项可启用 内联调试 功能,使您能够在编辑器中紧邻其用法处查看变量值。

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

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

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

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

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

    • 所有 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 时,您可以启用 'smart step into' 行为。 要这样做,请在 构建、执行、部署 | 调试器 | 单步执行 设置页面  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年 12月 2日