搜索用法
当您编写或编辑代码时,可能会遇到想要更改或删除的代码元素。 在进行更改之前,最好先查看代码元素的使用位置及其对应用程序的影响。 通过 查找用法 操作,您可以在整个代码库中搜索代码元素的引用。
您可以管理搜索过程,仅在单个文件中搜索,扩展搜索到整个项目,或创建特定的搜索范围。 此外,您可以配置用法高亮显示的颜色,或完全禁用用法的自动高亮显示。
在文件中搜索用法
在编辑器中选择您要查找的符号,PhpStorm 会自动突出显示文件中的所有使用情况。 如果 用法高亮被禁用,请按 Ctrl+Shift+F7 来高亮文件中的所有用法。

在 PHP 上下文中,PhpStorm 会自动高亮显示扩展和实现的方法、导入语句、退出点、抛出异常的位置以及循环语句。 当您将插入符号放置在
extends、实现、use、use trait、return、try、catch、@throws、break或continue关键字时,会触发高亮显示。符号的用法会根据其作用域进行高亮显示。 例如,
@throws的高亮显示不会应用于嵌套类和函数中。请前往 Ctrl+F7。 PhpStorm 选择文件中的第一次使用出现。

使用 F3 和 Shift+F3 快捷键在高亮符号之间导航。
在项目中搜索用法
选择您要查找用法的符号,右键点击该符号,然后从其上下文菜单中选择 或按 Alt+F7。
请在 Find 工具窗口中检查结果。
如果您需要,您可以按文件、包、目录等分组(
)结果。
PhpStorm 分析搜索结果,检测最常见的使用模式,并根据其结构相似性将所有找到的用法分类到不同的组中。 这些使用集群出现在 预览 选项卡中。
您可以从列表中选择任何组节点,然后点击 显示相似用法 以查看结果。
要禁用此功能,请清除 在“查找用法”视图中启用相似用法聚类 复选框,位于 高级设置 中。
在 查找 工具窗口中,您还可以使用 预览 区域来检查找到用法的位置,以查看方法的调用层次结构、字段的数据流等等。

您可以使用 查找用法 操作,作为 调用层次结构 操作的替代方案(Ctrl+Alt+H)。

预览找到的用法的源代码
您有多种选项可以查看找到的用法的源代码。
选择您要查找用法的符号,右键点击该符号,然后从其上下文菜单中选择 或按 Alt+F7。
在 查找 工具窗口中,单击
预览源 图标。
作为替代,您可以选择 跳转到源 ,如果您在找到的用途中调用上下文菜单,或 在拆分中显示。 在这种情况下,包含结果使用情况的文件会在编辑器中打开。
在单独窗口中显示用法
您可以在一个单独的窗口中查看所选符号的用法,您可以将该窗口移动到屏幕的不同部分,以便快速导航。
在编辑器中,选择您想查看用法的符号。
请前往 Ctrl+Alt+F7。

用法窗口显示当前范围和用法总数。 如果您想快速切换到默认范围,请按 Ctrl+Alt+F7。
如果搜索结果包含太多条目,那么 PhpStorm 会显示前一百个找到的用法,并在窗口底部显示 更多用法 选项,您可以点击以显示另一百个用法,如此类推,直到搜索完成。
使用窗口顶部的过滤器来显示或隐藏特定的搜索条目。
查看最近使用的搜索结果
PhpStorm 会记住您的 查找用法 结果,因此您不需要再次运行该操作。
在主菜单中,前往 然后选择使用查询。
管理 Find Usages 的范围
有时,您可能希望仅在项目的某些文件或库中查找用法。
禁用自动高亮显示用法
当您将文本光标放置在一个符号上时,IDE 会高亮显示该符号在当前文件中的所有用法。
如果有必要,您可以禁用自动高亮。
按 Ctrl+Alt+S 打开设置,然后选择 。
请清除 插入符号处元素的用法 复选框中的 文本光标移动时高亮 部分。
当自动高亮功能被禁用时,如果您想在当前文件中高亮显示一个符号的用法,请选择此符号并按下 Ctrl+Shift+F7。 这将突出显示当前文件中该符号的所有用法。
更改高亮显示用法的背景颜色
在 设置 对话框 (Ctrl+Alt+S) 中,前往 。
从右侧的选项中,打开 节点并选择 光标下的标识符。
请在 背景 字段中指定您需要的颜色并保存更改。
搜索基方法或方法的实现
当您搜索方法的用法时,PhpStorm 会提示您选择是搜索基方法还是方法的实现。
如果您选择 记住,不再询问 复选框,PhpStorm 将不再显示提示,并将所选的搜索选项用作默认选项。 如有必要,您可以恢复该提示。
在 设置 对话框 (Ctrl+Alt+S) 中,前往 。
在 PHP 区域,选择 在搜索方法用法时显示其他选项 复选框。

