调试工具窗口当您 启动调试会话 时,会打开 调试 工具窗口。 请使用此窗口来 控制调试会话、 查看并分析程序数据 (帧、变量等),并执行调试器操作。
本文概述 调试 工具窗口。 有关使用工具窗口的一般说明,请参阅 工具窗口。
默认情况下,当程序触发断点时,会打开 调试 工具窗口;会话终止时不会将其隐藏。 要更改此行为,请转到 构建、执行、部署 | 调试器 设置页面 Ctrl+Alt+S 并清除 在断点处显示调试窗口 复选框。
会话 选项卡
调试器控制台 选项卡
变量 和 监视
帧
调试器工具栏
会话可用的调试会话在 调试 工具窗口的顶部划分为各个选项卡。
如果您 启用服务工具窗口 用于特定运行/调试配置,在调试这些配置中的任何一个时,调试工具窗口的整个视图将显示在服务工具窗口内。
编辑器中的所有信息(如 内联变量值 和执行点)均针对所选会话选项卡显示。 如果您并行运行多个使用相同 的调试会话,这一点很重要。
当您关闭选项卡时,相应的调试会话将终止。
工具栏调试器工具栏包含用于 控制调试会话 和 步进 的最常用操作。
您可以根据偏好配置工具栏上可用的操作列表。
自定义调试器工具栏要添加调试操作,请右键点击调试器工具栏,在上下文菜单中选择 添加到调试器工具栏 ,然后在列表中选择所需的操作。
要添加与调试不直接相关的操作,请右键点击调试器工具栏,然后在上下文菜单中选择 自定义工具栏。
在打开的对话框中,点击 添加 ,然后选择所需的操作。
调试器工具栏无论选择哪个选项卡,您都可以始终使用窗口左侧的以下工具栏控件:
项目
工具提示和快捷键
说明
重新运行
Ctrl+F5
点击此按钮以停止当前应用并再次运行。
继续程序
F9
应用暂停时,点击此按钮可继续程序执行。
暂停程序
Ctrl+Pause
点击此按钮以暂停程序执行。
停止
Ctrl+F2
点击此按钮可通过标准 shutdown 脚本从外部终止当前进程。
点击该按钮一次会调用 软终止 ,允许应用捕获 SIGINT 事件并执行优雅终止(在 Windows 上会模拟
Ctrl+C
事件)。 首次点击该按钮后,它会被 替换,表示后续点击将导致强制终止应用;例如,在 Unix 上会发送 SIGKILL。
查看断点
Ctrl+Shift+F8
点击此按钮可打开 断点 对话框,您可以在其中配置断点行为。
静音断点
使用此按钮以切换断点状态。
当您 Debug 工具窗口的工具栏中按下 按钮时,项目中的所有断点将被静音,其图标将变为灰色: 。
您可以暂时将项目中的所有断点静音,以便在不在断点处停止的情况下执行程序。
更多
打开包含以下附加操作的菜单:
强制步过
智能步入
运行到光标处
显示执行点
计算表达式
调试器设置
修改运行配置
调试器设置
要使用此选项,请在 调试器 工具栏上点击 更多 ,然后选择 调试器设置。
打开包含以下选项的菜单:
在预览标签页中打开文件 :选择此选项可在选择相应帧时 在预览选项卡中打开文件。
在编辑器中显示变量值 :选择此选项可启用 内联调试 功能,使您能够在编辑器中紧邻其用法处查看变量值。
按字母顺序对变量进行排序 :选择此选项可按字母顺序对 变量窗格 中的值进行排序。
在会话完成时取消忽略断点 :选择此选项可在调试会话结束后重新启用所有已禁用的断点。
显示返回值 :选择此选项可在步进时在当前帧中显示已执行函数的返回值。
简化变量视图 :选择此选项可将以下名称包含到 特殊变量 组中:
所有具有 dunder 名称的变量。
所有 function、 classobj 和 module 的实例。
如果已启动带有 IPython 的调试控制台,则包含所有 IPython 内部变量。
变量加载策略。 您可以选择以下策略之一:
同步 :启用此选项时,显示的消息为 Collecting data ,之后调试器将显示变量的值。
异步 :启用此选项时,调试器中的变量将分别(异步)加载。 在这种情况下,如果加载某个变量耗时较长,调试器会显示 ...Loading Value 消息,之后才显示其值;如果该变量过慢,则显示 Loading timed out 消息。 请注意提示您切换到 按需 模式的警告消息。
按需 :启用此选项时,调试器会显示 Show Value 消息。 点击它以启用加载。
请注意,任何加载策略的更改都会在您重新运行调试过程后生效。
项目
工具提示和快捷键
说明
重新运行
Ctrl+F5
点击此按钮以停止当前应用并再次运行。
继续程序
F9
应用暂停时,点击此按钮可继续程序执行。
暂停程序
Ctrl+Pause
点击此按钮以暂停程序执行。
停止
Ctrl+F2
点击此按钮可通过标准 shutdown 脚本从外部终止当前进程。
查看断点
Ctrl+Shift+F8
点击此按钮可打开 断点 对话框,您可以在其中配置断点行为。
静音断点
使用此按钮以切换断点状态。
当您 Debug 工具窗口的工具栏中按下 按钮时,项目中的所有断点将被静音,其图标将变为灰色: 。
您可以暂时将项目中的所有断点静音,以便在不在断点处停止的情况下执行程序。
设置
点击此按钮以打开包含以下选项的菜单:
内联显示值 :选择此选项可启用 内联调试 功能,使您能够在编辑器中紧邻其用法处查看变量值。
按字母顺序排列值 :选择此选项可按字母顺序对 变量窗格 中的值进行排序。
会话结束时取消静音断点 :选择此选项可在调试会话结束后重新启用所有已禁用的断点。
显示返回值 :选择此选项可在步进时在当前帧中显示已执行函数的返回值。
简化的变量视图 :选择此选项可将以下名称包含到 特殊变量 组中:
所有具有 dunder 名称的变量。
所有 function、 classobj 和 module 的实例。
如果已启动带有 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() 的实现,依此类推。
使用 [DebuggerStepThrough] 特性修饰的方法不会作为步进目标提供建议。
如果您想选择应步入哪个调用,例如 Bar() ,您可以使用 智能步入 Shift+F7:
当您选择要步入的函数时,调试器会将执行指针设置在所选函数的第一条语句处。
该选择器还会显示哪些调用已执行,并允许您再次执行这些调用。
当您在包含多个方法调用的行上调用 步入 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
点击此按钮以 计算表达式。
布局设置显示/隐藏选项卡点击 布局设置 在 调试 工具窗口的右上角。
在打开的上下文菜单中,选择您要显示或隐藏的选项卡(窗格)。 选中的窗格和选项卡标有复选标记。
默认情况下, 监视 窗格处于隐藏状态。 要单独显示它,请选择 单独显示监视。
有关更多信息,请参阅 打开监视窗格。
显示选项卡标签使用此选项以显示调试器选项卡和窗格的名称。
点击 布局设置 在 调试 工具窗口的右上角。
在打开的上下文菜单中选择 显示选项卡标签。
恢复默认布局如果您更改了 调试 工具窗口的布局,您可以将其恢复到默认状态。
点击 布局设置 在 调试 工具窗口的右上角。
在打开的上下文菜单中选择 恢复默认布局。
最后修改日期: 2025年 12月 2日第 3 部分。 调试 JavaScript线程与变量选项卡