PyCharm 2026.2 Help

调试工具窗口

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

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

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

  2. 调试器控制台 选项卡

  3. 变量 和 监视

  4. 帧

  5. 调试器工具栏

会话

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

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

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

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

工具栏

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

调试器工具栏

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

自定义调试器工具栏

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

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

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

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

调试器工具栏

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

项目

工具提示与快捷键

描述

重启

重新运行

Ctrl+F5

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

继续

继续程序

F9

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

暂停

暂停程序

Ctrl+Pause

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

停止

停止

Ctrl+F2

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

点击此按钮一次会调用 软终止 ,使应用能够捕获 SIGINT 事件并执行优雅终止(在 Windows 上,会模拟 Ctrl+C 事件)。 按钮被点击一次后,它会被替换为 强制终止按钮 ,表示随后点击将导致应用被强制终止,例如在 Unix 上会发送 SIGKILL。

查看断点

查看断点

Ctrl+Shift+F8

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

静默断点

静音断点

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

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

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

更多

更多

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

显示选项菜单

调试器设置

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

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

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

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

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

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

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

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

    • 所有 function、 classobj 和 模块 的实例。

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

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

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

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

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

    请注意,更改加载策略后,需重新运行调试方可生效。

项目

工具提示与快捷键

描述

重启

重新运行

Ctrl+F5

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

继续

继续程序

F9

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

暂停

暂停程序

Ctrl+Pause

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

停止

停止

Ctrl+F2

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

查看断点

查看断点

Ctrl+Shift+F8

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

静默断点

静音断点

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

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

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

显示选项菜单

设置

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

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

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

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

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

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

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

    • 所有 function、 classobj 和 模块 的实例。

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

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

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

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

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

    请注意,更改加载策略后,需重新运行调试方可生效。

固定选项卡

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

步进工具栏

项目

工具提示与快捷键

描述

显示执行点

显示执行点

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. 在打开的上下文菜单中选择 恢复默认布局。

    恢复默认布局
2026年 7月 14日