PhpStorm 2025.2 Help

检查挂起的程序

在调试器会话 启动后, Debug工具窗口会出现,程序会正常运行,直到发生以下情况之一:

之后,程序将被挂起,允许您检查其当前状态、控制其进一步执行并在运行时测试各种场景。

检查帧

程序的状态由 frames表示。 当程序暂停时,当前的帧堆栈将显示在 选项卡中的 调试 工具窗口内。

帧选项卡

帧对应于活动的方法或函数调用。 它存储了被调用方法或函数的局部变量、其参数以及使表达式求值成为可能的代码上下文。

每次调用 method 时,都会在栈顶新增一个帧。 当 method 的执行完成时,相应的帧将从堆栈中移除(最后一个进,最先一个出)。

检查帧有助于您了解为什么特定参数被传递给方法,以及调用者在调用时的状态。

复制堆栈到剪贴板

  • 要复制当前线程的调用堆栈,请右键点击 选项卡上的任意位置,然后选择 复制堆栈

检查/更新变量

变量 选项卡显示所选 帧/线程中的变量列表。 检查变量可以帮助您理解程序为何以某种方式运行。

变量选项卡显示当前执行点可见的变量

每个变量左侧的图标表示其类型。

用户定义的 常量被分组在一个单独的 常量 节点下,默认情况下是折叠的。 一旦展开或折叠, 常量 节点会在调试会话中保留此状态。 请注意,如果用户定义的常量数量较多,单步执行性能可能会下降。 如果需要,您可以通过单击 显示用户定义常量按钮 工具栏上的 调试工具窗口 来禁用在调试会话期间获取这些常量。 常量 节点将被隐藏。

复制变量

在检查变量时,您可能需要复制变量名称或值以粘贴到其他地方或将其与另一个变量进行 比较

  • 要复制变量的名称,请右键点击变量并选择 复制名称

  • 要复制变量所持有的值,请右键点击变量并选择 复制值 Ctrl+C

与剪贴板比较变量

将变量值与其他值进行比较,请使用 与剪贴板比较值 选项。 这很有用,例如,当一个变量包含一个长字符串时,您需要将其与另一个长字符串进行比较。

  1. 将您想要比较的内容复制,例如,从一个文本文件中。

  2. 变量 选项卡中,右键单击一个变量并选择 与剪贴板比较值

  3. 查看打开的 差异查看器 中的差异。 如需了解更多关于 差异查看器 的信息,请参阅 比较文件和文件夹

在专用对话框中查看变量

PhpStorm 允许您在专用对话框中检查变量。 这在您需要跟踪某个变量(或它所持有引用的对象)并且同时能够在帧和线程之间导航时非常有用。

  • 右键点击变量或监视并选择 Inspect

    检查对话框

设置变量值

如果您想测试程序在特定数据下的行为或在运行时更改其流程,可以通过更改变量值来实现。

  1. 选择一个变量并按 F2。 或者,从上下文菜单中选择 设置值

  2. 请输入变量的值然后按 Enter

    在变量名称右侧的字段中输入新值

instance="rm"/>

您可以从 变量 窗格导航到声明。

  • 要导航到变量声明的代码位置,请右键点击变量并选择 跳转到源 F4

  • 要导航到变量类型的类声明,请右键点击该变量,然后选择 跳转到类型源 Shift+F4

    假设,您有 $my_car = new Car();。 如果您在 变量 窗格中选择 $my_car ,然后选择 跳转到源 将带您到 $my_car = new Car(); ,而选择 跳转到类型源 将带您到 class Car()

  • 要从调用元素导航到回调函数声明,请单击 导航 ,该元素旁边的 变量 窗格。

    单击“导航”将带您到相应回调函数的代码

计算表达式

PhpStorm 允许您在调试会话中评估表达式,以获取有关程序状态的更多详细信息或在运行时测试各种执行场景。

此功能仅在程序在命中断点后暂停(而非 暂停 )时有效。

如果表达式中调用的方法内有断点,它们将被忽略。

在编辑器中评估一个简单表达式

要快速评估表达式,请在编辑器中指向它。 请注意,方法调用无法以这种方式评估。

  1. 指向您要计算的表达式。 表达式的结果显示在工具提示中。

    值提示
  2. 要查看子元素,请单击 “展开”按钮 或按 Ctrl+F1

    值提示

如果您觉得数值工具提示干扰到了您的操作,您可以增加延迟时间或完全禁用它们。 为此,请在 设置 对话框(Ctrl+Alt+S )中,转到 构建、执行、部署 | 调试器 | 数据视图 并根据您的偏好设置 显示值提示值工具提示延迟 选项。

在编辑器中评估复杂表达式

如果您想在代码中评估涉及方法调用的表达式或指示要评估的表达式的特定部分,请使用 快速求值表达式 选项。

  • 选择表达式并按下 Ctrl+Alt+F8 ,或从出现的浮动工具栏中选择 计算表达式

    值工具提示出现
  • 或者,转到 运行 | 调试操作 | 快速计算表达式

您可以配置 快速求值表达式 使其只在选择一段代码时运行(无需使用菜单/快捷键)。 启用此选项时请谨慎操作,因为您可能会意外调用方法。

选中代码时评估表达式

  • 前往 设置 | 构建、执行、部署 | 调试器 | 数据视图 并设置 在代码选择上显示值提示 选项。

计算任意表达式

评估任意表达式是最灵活的评估选项。 它允许您评估任何自定义代码,只要它在当前帧的上下文中。 使用它,您可以计算声明、方法调用、匿名类、lambda、循环等。

  1. 要评估任意表达式,请在 计算表达式 字段中输入它,然后在 变量 窗格中按 Enter

    在变量选项卡中的表达式
  2. 结果显示在下面。 您还可以通过点击表达式字段右侧的 将表达式添加到 watches

    变量选项卡中表达式的结果

如果您想评估长代码块,您可能需要为此使用专用对话框:

在专用对话框中评估表达式

  1. 如果您想从当前在您面前的某个表达式或变量开始(例如,在编辑器或 变量 窗格上),请选择它。

    选择要从中开始的表达式
  2. 前往 运行 | 调试操作 | 计算表达式 Alt+F8 或从上下文菜单中选择 计算表达式。 快捷键可能在 Ubuntu 上无法使用(为正确操作, 调整快捷键配置)。

  3. 计算 对话框中,修改所选表达式或在 表达式 字段中输入一个新的。 点击 展开 Shift+Enter 以修改多行代码片段。

    表达式输入在 Code Fragment 字段中
  4. 点击 计算Ctrl+Enter 以进入多行模式)。 表达式结果显示在 Result 字段中。

    表达式的结果取自返回语句。 当没有 return 语句时,结果取自代码的最后一行(甚至不必是表达式:单个字面量也可以)。 当没有有效的行可取值时,结果是 undefined。 如果无法计算指定表达式, Result 字段将指示原因。

    表达式结果已计算

计算 对话框是非模态的,因此您可以将焦点切换回编辑器以复制其他变量和表达式。 您还可以打开多个 计算 对话框。

在控制台中计算变量

在 PHP 和 JavaScript 上下文中,您可以通过使用交互式控制台在调试会话期间查看变量的值。

  • 变量 窗格中选择变量,并从选择的上下文菜单中选择 在控制台中计算

    当您切换到 Console 窗格时,变量名称以绿色显示在 > ,其值以蓝色显示在下方。

    调试控制台输出
  • 单击 使用控制台输入 “使用控制台输入”按钮 切换按钮,并在 Console> 中键入任何变量的名称,然后按 Enter 以显示其值。

    代码补全 Ctrl+Space 可用:当您键入变量名称时,PhpStorm 会显示建议列表。

  • 要计算先前计算过的变量,请使用键盘上的 箭头找到它并按 Enter

在控制台中执行代码

在 PHP 调试会话期间,您不仅可以计算变量,还可以更改其值、调用 PHP 函数,并直接在 Console 窗格中定义其他函数。 请注意,此功能不适用于 Behat运行/调试配置。

  1. Console 窗格的 Debug 工具窗口中,单击工具栏上的 使用控制台输入 切换按钮 “使用控制台输入”按钮

    • 当此切换按钮显示为按下状态时,您可以在 Console 窗格中动态计算和更改变量、调用 PHP 函数以及定义其他函数。

    • 当此切换按钮显示为未按下状态时, Console 窗格中的任何输入都会被视为 STDIN

  2. > 中键入语句或表达式,然后按 Enter。 PhpStorm 会计算您的代码片段,并在输入代码下方显示输出。 您可以键入大多数 PHP 构造,包括类声明、函数声明、变量、表达式等。 代码补全 Ctrl+Space 可用:当您键入时,PhpStorm 会显示建议列表。

  3. 在输入多行代码片段时,按 Shift+Enter 开始新行,并按 Ctrl+Enter 断行。

  4. 数组和对象的输出默认包装在 var_export() 函数中,并显示在 Console 中。 要隐藏显示的输出,请清除 Debug 页面上的 在调试控制台中显示数组和对象的子项 复选框。

内联查看值

PhpStorm 在变量使用的旁边显示其值。

一旦变量值更改,内联视图将会更新为新值并更改其颜色。

变量的内联值随每一步骤而变化

如果某行包含对对象的引用,您可以直接在编辑器中检查其属性。 在此弹出窗口中,您还可以 更改变量值添加内联监视

添加内联监视选项

默认情况下,内联视图是启用的。 要关闭此功能,请在 设置 对话框(Ctrl+Alt+S )中,转到 构建、执行、部署 | 调试器 | 数据视图 并禁用 内联显示值 选项。

添加内联监视

如果您希望某个表达式的结果显示在特定的行上,您可以为此设置一个内联 watch。 内联监视是持久的,并且在会话重启后仍然保持活动状态。

  1. 单击与您想要跟踪的对象属性相关的内联提示。

  2. 在弹出窗口中,选择属性并单击 添加为内联监视

    添加内联监视选项
  3. 如有需要,微调 watch。 您可以使用任何有效的表达式作为监视。

    设置内联监视

您在编辑器中设置的内联监视也会显示在 调试 工具窗口的“变量”窗格中的 内联监视 下。

要删除行内监视,请将鼠标悬停在监视上,然后点击旁边的叉号。

可视化 JSON 和 XML

当您展开 内联值计算包含 JSON 或 XML 的字符串表达式时,PhpStorm 会为您提供数据的结构化和格式化视图。

这使您可以使用编辑器功能,例如 代码折叠扩展或缩小选择 ,以便处理子树并在大型对象中方便导航。

使用预览弹出窗口中的选项卡在结构化视图和原始视图之间切换:

%alt

查看数据流分析预测

PhpStorm 支持在 Xdebug 会话中进行数据流分析辅助调试。 基于从调试器在 断点处接收到的信息,PhpStorm 显示有关在执行的代码片段中条件检查将发生什么的提示。

显示条件结果的提示

代码路径中预测在执行期间不可达的代码块会变灰。

不可达的代码块会变灰

禁用内联预测提示

  • 仅针对当前调试会话:右键单击任意提示并选择 关闭数据流辅助

    关闭数据流辅助
  • 针对所有后续调试会话:在 设置 对话框(Ctrl+Alt+S )中,转到 PHP | 调试 并清除 Xdebug 区域中的 通过分析程序数据流预测未来条件值 复选框。

禁用不可达代码的灰显

  • 设置 对话框(Ctrl+Alt+S )中,转到 PHP | 调试 并清除 Xdebug 区域中的 将预测为不可达的代码块变灰 复选框。

监视

如果您想跟踪某个变量或更复杂表达式的结果,请为此变量或表达式设置监视。 当您需要计算未定期显示在变量列表中的内容,或固定某些实例变量以消除每次 单步后展开树的需要时,这非常有用。

此功能仅在程序在命中断点后暂停(而非 暂停 )时有效。

在所选帧的上下文中评估 Watches。 监视在上下文之外或编译失败时无法评估。 如果是这种情况,手表将标有错误图标 错误图标

默认情况下,监视会与变量一起显示在 变量 窗格中。 要隐藏/显示 监视 窗格,请使用 分离 watches 选项,该选项位于 布局设置 恢复布局按钮 菜单中。

添加监视

根据您想要跟踪的表达式:

  • 对于编辑器中的表达式——选择表达式,然后单击浮动工具栏中出现的 添加到监视 图标 。 或者,将表达式拖动到 变量 选项卡。

    浮动工具栏中的 Add to Watches 按钮
  • 对于当前上下文中的元素——右键单击 变量 选项卡中的变量,然后从菜单中选择 添加到监视

  • 对于任意表达式——在 变量 选项卡的顶部部分输入表达式,然后单击 添加到监视

    变量选项卡中的表达式

编辑监视

  • 右键点击所需的监视器,然后选择 编辑

复制监视

  1. 选择您想要复制的监视。

  2. 单击 复制监视 “复制监视”按钮 位于 变量/监视 选项卡上,或按 Ctrl+D

更改监视的顺序

为了方便起见,您可以更改监视在 变量/监视 窗格中显示的顺序。

  • 使用 变量/监视 窗格上的 上移监视/下移监视 按钮或 Ctrl+UpCtrl+Down 键盘快捷键。

删除监视

  • 要移除单个监视,请右键点击并选择 移除监视。 或者,在 变量/监视 窗格中选择监视并按 Delete

  • 要移除所有监视,请右键单击 变量/监视 窗格上的任意位置,然后选择 移除所有监视

监视允许执行与变量相同的操作。 例如,您可以 在专用对话框中查看它们 ,或使用它们 导航到源代码

监视是您项目的一部分。 这意味着您可以停止并重新运行调试会话而不会有丢失它们的风险。

暂停和恢复监视

有时,监视可能依赖于本地上下文或涉及大量计算,使其在某些步骤中难以评估。 在这种情况下,您可以暂停监视并按需评估它。

  • 要暂停监视,请右键单击它并选择 暂停监视

    暂停监视
  • 要恢复监视,请右键单击它并选择 恢复监视

  • 要对暂停的监视进行一次性评估,请单击监视附近的 计算

    计算暂停的监视

执行点

返回当前执行点

检查程序状态涉及在代码中导航,您经常需要返回到程序挂起的位置。

请执行以下操作之一:

  • 在主菜单中,进入 运行(U)| 调试操作|显示执行点.

  • 按下 Alt+F10

  • 点击 更多 按钮 ,位于 调试 工具窗口的步进工具栏上,然后从打开的上下文菜单中选择 显示执行点按钮显示执行点

当前的执行点用蓝色线条表示。 此行代码尚未执行。

指示当前执行点的蓝线
最后修改日期: 2025年 9月 26日