PhpStorm 2021.3 Help

检查暂停的程序

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

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

检查框架

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

框架选项卡

一个框架对应于活动的方法或函数调用。它存储被调用方法或函数的局部变量、其参数以及启用表达式求值的代码上下文。

每次调用方法时,都会在堆栈顶部添加一个新帧。当一个方法的执行完成时,相应的帧从堆栈中移除(以后进先出的方式)。

检查框架可以帮助您了解为什么将特定参数传递给方法以及调用者在调用时的状态。

将堆栈复制到剪贴板

  • 要复制当前线程的调用堆栈,请右键单击Frames选项卡上的任意位置并选择Copy Stack

检查/更新变量

变量选项卡显示所选框架/线程中的变量列表。检查变量有助于理解程序为何以某种方式运行。

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

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

用户定义的常量被分组在一个单独的常量节点下,默认情况下是折叠的。展开或折叠后,Constants节点会在调试会话中保留此状态。请注意,如果用户定义的常量数量很大,则步进性能可能会降低。显示用户定义的常量按钮如有必要,您可以在调试会话期间通过单击调试工具窗口工具栏来禁用获取此类常量。常量节点将被隐藏。

复制变量

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

  • 要复制变量保存的值,请右键单击该变量并选择Copy Value Ctrl+C

  • 要复制变量的名称,请右键单击该变量并选择Copy Name

将变量与剪贴板进行比较

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

  1. 复制您要比较的内容(例如,从文本文件中)。

  2. 变量选项卡中,右键单击要与之比较的变量,然后选择将值与剪贴板进行比较

  3. 检查打开的差异查看器中的差异。有关如何有效使用差异查看器的其他信息,请参阅比较文件和文件夹主题。

在专用对话框中查看变量

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

  • 右键单击变量选项卡上的变量并选择检查

    检查对话框

设置变量值

如果需要测试程序在特定条件下的行为或在运行时修复其当前行为,您可以通过设置/更改变量值来实现。

  1. 右键单击变量选项卡上的变量并选择设置值,或选择变量并按F2

  2. 输入变量的值并按Enter

    在变量名称旁边的字段中输入变量的新值

如果您需要查看声明了某个变量或类的源代码,您可以直接从“变量”选项卡移到那里。

  • 要导航到声明变量的代码,请右键单击变量并选择Jump to Source F4

  • 要导航到变量类型的类声明,请右键单击变量并选择Jump to Type Source F4

    假设,你有$my_car = new Car();. 如果您$my_car在“变量”窗格中选择,则选择Jump To Source将带您到,$my_car = new Car();而选择Jump To Type Source将带您到class Car().

评估表达式

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

在编辑器中计算一个简单的表达式

评估表达式的最简单方法是在代码中指向它。虽然这是最快的方法,但它不能用于评估方法调用。这样做是为了安全,因为它们可能会产生副作用。

当您需要从编辑器快速计算表达式时,请使用此选项。

  1. 指向您要评估的表达式。表达式的结果出现在工具提示中。

    值工具提示
  2. 如果您需要查看子元素,请单击展开按钮或按Ctrl+F1

    值工具提示

如果您发现价值工具提示令人分心,您可以增加延迟或完全禁用它们。为此,在设置/首选项对话框 ( Ctrl+Alt+S) 中,转到构建、执行、部署 | 调试器 | 数据视图并根据需要设置显示值工具提示值工具提示延迟选项。

在编辑器中计算一个复杂的表达式

如果要计算代码中涉及方法调用的表达式,或者要具体说明要计算表达式的哪个部分,请使用“快速计算表达式”选项。

仅当程序在遇到断点后暂停(不是手动暂停)时,此选项才可用。

  1. 将插入符号放在表达式上(以评估最接近的匹配表达式)或选择其中的一部分(如果您想具体说明要评估复杂表达式的哪一部分)。

  2. 单击运行 | 调试操作 | 快速评估表达式 Ctrl+Alt+F8

    出现值工具提示

您可以将快速评估配置为只需选择一段代码即可(不使用菜单/快捷方式)。请谨慎使用此选项,因为启用它时您可能会意外调用方法。

要配置代码选择的快速评估,请转到设置/首选项 | 构建、执行、部署 | 调试器 | 数据视图并将在代码选择上显示值工具提示选项设置为首选。

评估任意表达式

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

使用此功能可获取有关程序当前状态的其他信息,并在同一调试会话中测试各种场景。这通过减少您必须运行的会话数量来节省大量时间。

仅当程序在遇到断点后暂停(不是手动暂停)时,此选项才可用。

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

    选择要开始的表达式
  2. 单击运行 | 调试操作 | 评估表达式 Alt+F8。快捷方式可能在 Ubuntu 上不起作用(为了正确操作,请调整快捷方式配置)。

  3. 在“评估”对话框中,修改选定的表达式或在“表达式”字段中输入新的表达式。如果您要评估代码片段,请单击展开 Shift+Enter

    在代码片段字段中输入表达式
  4. 单击评估Ctrl+Enter对于多行模式)。表达式结果出现在结果字段中。

    表达式的结果取自 return 语句。当没有 return 语句时,结果取自代码的最后一行(它甚至不必是表达式:文字也可以)。当没有有效的行可以取值时,结果为undefined. 如果无法评估指定的表达式,则Result字段指示原因。

    表达式结果计算

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

在控制台中评估变量

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

  • 变量窗格中选择变量,然后从选择的上下文菜单中选择在控制台中评估。

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

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

    可以使用代码完成Ctrl+Space:当您键入变量的名称时,PhpStorm 会显示一个建议列表。

  • 要评估先前评估的变量,请使用键盘上的向上向下Enter箭头找到它,然后按。

在控制台中执行代码

在 PHP 调试会话期间,您不仅可以评估变量,还可以更改它们的值、调用 PHP 函数以及直接在控制台窗格中定义其他函数。请注意,此功能不适用于PHPUnitBehat运行/调试配置。

  1. 调试工具窗口的控制台窗格中,单击工具栏上的使用控制台输入切换按钮。使用控制台输入按钮

    • 当此切换按钮按下时,您可以在控制台窗格中评估和更改变量、调用 PHP 函数以及动态定义其他函数。

    • 当切换按钮未按下时,控制台窗格中的任何输入都被视为STDIN.

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

  3. 键入多行代码片段时,按下Shift+Enter可开始新行并Ctrl+Enter拆分行。

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

内联查看值

PhpStorm 通过在变量使用旁边显示变量的值来促进调试过程。

一旦变量值改变了,内联视图就会用新值更新并改变它的颜色。

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

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

内联调试器提示

默认情况下启用内联值视图。要关闭它,在Settings/Preferences对话框 ( Ctrl+Alt+S) 中,转到Build, Execution, Deployment | 调试器 | 数据视图并禁用显示值内联选项。

添加内联手表

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

  1. 单击引用要跟踪其属性的对象的内联提示。

  2. 在弹出窗口中,选择属性并单击Add as Inline Watch

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

    设置内联手表

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

要移除内嵌手表,请将鼠标悬停在手表上并单击其附近的十字。

手表

如果要跟踪某个变量或更复杂表达式的结果,请为此变量或表达式设置监视。当您需要添加一些不经常显示在变量列表中的内容或固定某个实例变量从而消除在每一步之后展开树的需要时,这很有用。

仅当程序在遇到断点后暂停(不是手动暂停)时,此选项才可用。

手表在所选帧的上下文中进行评估。当手表脱离上下文或编译失败时,它们不能被评估。如果是这种情况,手表会标有错误图标错误图标

默认情况下,Watches选项卡处于隐藏状态,而 Watches 显示在Variables选项卡上。要隐藏/显示Watches选项卡,请使用VariablesWatches选项卡上的Show Watches in variables 选项卡按钮。在变量选项卡中显示手表

添加手表

  1. Watches选项卡上单击 New Watch 。 新的观看按钮

  2. 输入要计算的变量或表达式。在表达式中,只要在本地上下文中,您就可以评估方法调用、lambda 声明变量等。

    观看表情

将变量/表达式添加到Watches后,它会保留在那里并针对每个step进行评估,从而为您提供当前上下文中的结果。

编辑手表

  • 右键单击所需的手表并选择Edit

复制手表

  1. 选择您要复制的手表。

  2. 单击变量/监视选项卡上的重复监视 或按。重复观看按钮Ctrl+D

更改手表的顺序

为方便起见,您可以更改手表在变量/手表选项卡上的显示顺序。

  • 使用“变量/监视”选项卡上的“向上移动监视” / “向下移动监视”按钮或键盘快捷键。Ctrl+UpCtrl+Down

删除手表

  • 要删除单个监视,请右键单击它并在变量/监视选项卡上选择删除监视。 Delete

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

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

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

返回当前执行点

检查程序状态涉及在代码中导航,并且您经常需要返回到程序暂停的地方。

执行以下操作之一:

  • 从主菜单中,选择运行 | 调试操作 | 显示执行点

  • Alt+F10

  • 单击调试工具窗口显示执行点按钮的步进工具栏。

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

蓝线表示当前执行点
最后修改:2022 年 2 月 21 日