PhpStorm 2026.3 Help

内嵌提示

内联提示显示在编辑器中,为您的代码提供附加信息,使其更易于阅读和导航。

嵌入提示示例

启用或禁用内嵌提示

  • 要禁用编辑器中当前显示的提示:

    右键单击提示,并选择是要禁用特定类型的提示还是此类别中的所有提示。

    隐藏代码作者名称
  • 要配置一个或多个特定组的内嵌提示:

    打开 设置 对话框(Ctrl+Alt+S ),转到 编辑器 | 内联提示 ,并使用提示旁边的复选框来隐藏或显示相应类别的内嵌提示。

    设置 | 内嵌提示
  • 要禁用特定 PHP 方法的嵌入提示:

    打开 设置 对话框(Ctrl+Alt+S ),转到 编辑器 | 内联提示 ,然后点击 排除列表。 在打开的对话框中,使用完全限定名称或通配符语法指定要排除的符号列表。

    设置 | 内嵌提示
  • 要一次性启用或禁用所有嵌入提示,请在 全局切换嵌入提示 操作中使用 Search Everywhere 对话框。

    按 Ctrl+Shift+A ,开始输入 全局切换嵌入提示。 使用切换按钮在 PhpStorm 启用或禁用嵌入提示。

    此外,可以为此操作分配快捷键。 打开 设置 对话框(Ctrl+Alt+S ),然后转到 键位图 页面。 在搜索字段中输入 全局切换嵌入提示 ,然后按两次点击该操作为其设置快捷键。 有关更多信息,请参见 键盘快捷键。

代码视图

Code Vision 提示会显示符号的继承者数量和用法数量,显示其作者,并标记新的符号或包含未提交更改的符号。

当您将鼠标悬停在提示上时,它会变成一个链接。 通过单击链接,您可以导航到类或接口的用法或实现,以及打开版本控制注释。

  • 继承者 显示类(继承者)、接口(实现)或特性(被使用)的后代数量。 单击提示以跳转到后代。 如果有多个后代,从列表中选择相关的一个。 从 转到实现了解更多信息。

    内嵌提示,代码视图:跳转到继承者
  • 用法 显示类或方法在项目中被使用的次数。 单击提示以跳转到用法或从列表中选择相关的一个。 了解更多信息,请参阅 在项目中搜索用法。

    内嵌提示,代码视图:跳转到用法
  • 代码作者 显示在给定代码元素中编写/编辑最多代码行的人员。 提示还指示该元素是否是新的、在当前修订中被修改过,或者是否有多个贡献者对其进行了大量提交。 单击提示以在边距中打开 Git 注释。 从 定位代码作者了解更多信息。

    内嵌提示,代码视图:代码作者

在对话框的右侧窗格中,配置内嵌提示的默认位置——是显示在符号上方还是右侧,并指定每个位置要显示的内嵌提示的最大数量。

代码视图:配置默认设置

您还可以为特定类型的提示配置自定义位置。

在设置对话框中配置内嵌提示的位置

参数名称

显示函数和方法调用中参数的名称。 这些提示可帮助您为函数和方法传递正确的参数。

PHP 特定的参数名称选项为:

  • 显示所有实参的名称 :如果选中,将为所有参数显示参数名称提示。 否则,仅为字面量或 null 值显示参数提示,而不显示命名对象的提示。

    字面量的参数提示
  • 始终显示按引用传递 :如果选中,将为 & 按引用传递的参数显示参数提示 https://php.net/manual/en/language.references.pass.php。 如果清除了 显示所有实参的名称 复选框,则与参数名称匹配的参数名称将被省略。

    按引用传递的参数的参数提示

对于一些方法和函数,默认情况下不会显示参数名称:这些方法和函数位于默认 排除列表 中。 要重新启用被排除的参数名称提示,或添加更多被排除的方法或函数,请单击 排除列表 并编辑列表。

设置 | 内嵌提示
Pytest 形参化名称

使用 @pytest.mark.parametrize decorator 时显示参数名称,以明确哪个值映射到每个测试参数。

配置嵌入提示的外观

嵌入提示的颜色和样式来自配色方案。 其大小基于编辑器字体:大多数提示的渲染比周围代码小一个点,并遵循编辑器缩放级别。 默认情况下,PhpStorm 使用为 IDE 用户接口配置的字体。

更改嵌入提示的颜色和样式

  1. 在 设置 对话框 Ctrl+Alt+S 中,进入 编辑器|配色方案|语言默认值 ,然后选择 内联提示。

  2. 选择内嵌提示类型和状态,并根据需要配置字体颜色和效果。

对嵌入提示使用编辑器字体

  1. 在 设置 对话框(Ctrl+Alt+S ),转到 编辑器|常规|外观。

  2. 请选择 为嵌入提示使用编辑器字体 选项。

启用该选项后,PhpStorm 会将 设置 | 编辑器 | 字体 中配置的字体用于嵌入提示。

2026年 11月 9日