GoLand 2025.2 Help

搜索用法

当您编写或编辑代码时,可能会遇到想要更改或删除的代码元素。 在进行更改之前,查看代码元素的使用位置及其对应用程序的影响是一个良好的实践。 使用 查找用法 操作,您可以在整个代码库中搜索代码元素的引用。

您可以管理搜索过程,仅在单个文件中搜索,将搜索范围扩展至整个项目,或创建特定的搜索范围。 此外,您可以配置用法高亮显示的颜色,或完全禁用自动高亮功能。

在文件中搜索用法

  • 在编辑器中,选择要查找的符号,GoLand 会自动高亮显示文件中找到的所有用法。 如果已禁用 用法高亮显示 ,请按 Ctrl+Shift+F7 以高亮显示文件中的所有用法。

    在文件中查找用法的结果
  • 前往 编辑 | 查找用法 | 查找文件中的用法 Ctrl+F7。 GoLand 会选中文件中首次出现的用法。

    查找用法的结果

使用快捷键 F3Shift+F3 在高亮符号之间导航。

在项目中搜索用法

  • 选择要查找用法的符号,右键点击该符号,并从其上下文菜单中选择 查找用法 ,或按 Alt+F7。 当按下 (Alt+F7) 时,GoLand 会查找接口方法的用法。 要查找当前方法的用法,请按 Ctrl+Alt+Shift+F7

    Find 工具窗口中查看结果。

    如有需要,您可以按文件、包、目录等对结果进行分组(按分组图标)。

    GoLand 分析搜索结果,检测最常见的使用模式,并根据结构相似性将所有用法归类为组。 这些用法集群显示在 预览 选项卡中。

    您可以从列表中选择任意组节点并点击 显示类似用法 来查看结果。

    要禁用此功能,请在 高级设置 中清除 在“查找用法”视图中启用相似用法分组 复选框。

    Find 工具窗口的预览区域

预览已找到用法的源代码

您有多种方式查看已找到用法的源代码。

  1. 选择要查找用法的符号,右键点击该符号,并从其上下文菜单中选择 查找用法 ,或按 Alt+F7

  2. 查找 工具窗口中,点击 预览源代码预览源 图标。

    预览已找到用法的源代码

    作为替代,您可以在用法结果上点击右键,选择 跳转到源 ,或 以拆分视图方式显示。 此时,用法结果所在文件将在编辑器中打开。

在单独窗口中显示用法

您可以在可移动至屏幕任意位置的单独窗口中查看所选符号的用法,并用于快速导航。

  1. 在编辑器中选择要查看用法的符号。

  2. 前往 编辑 | 查找用法 | 在代码中显示用法 Ctrl+Alt+F7

    显示用法结果窗口

    用法窗口显示当前的作用域和用法总数。 如需快速切换到默认范围,请按 Ctrl+Alt+F7

    如果搜索结果项过多,GoLand 会显示前一百条用法,并在窗口底部显示 更多用法 选项,点击可加载另外一百条,以此类推直到搜索完成。

    使用窗口顶部的筛选器可以显示或隐藏特定的搜索项。

查看最近的用法搜索结果

GoLand 会记住您的 查找用法 结果,因此无需再次执行此操作。

  • 在主菜单中,打开 编辑 | 查找 | 最近的查找用法 ,然后选择使用查询。

管理“查找用法”的范围

有时,您可能只想查找项目中某些文件或库中的用法。

  1. 按下 Ctrl+Alt+Shift+F7 打开 查找用法 对话框。

    按下 Ctrl+Alt+Shift+F7 时,将查找当前方法的用法。 要查找接口方法的用法,请按 Alt+F7

  2. 查找用法 对话框中的 范围 字段中,选择搜索范围。 例如,您可以仅在 打开的文件 中搜索用法,或仅在 最近更改的文件 中搜索。

    Find Usages 对话框(更改范围)

    您还可以点击 省略号图标 来设置自定义 范围。 例如,您可以创建自定义范围,以在搜索用法时排除某些文件,例如测试文件。 设置新范围后,点击 查找

    如果 GoLand 未返回任何结果,将显示一条消息,建议选择更多选项。

    未找到用法弹窗

    您可以点击该链接,或按 Ctrl+Alt+Shift+F7 再次打开 查找用法 对话框,并为搜索设置新范围。

禁用自动高亮显示用法

当光标位于某个符号上时,IDE 会在当前文件中高亮显示该符号的所有用法。

如有需要,您可以禁用自动高亮显示功能。

  1. Ctrl+Alt+S 打开设置,然后选择 编辑器 | 代码编辑

  2. 插入符号移动时高亮显示 部分中取消选中 插入符号处元素的用法 复选框。

禁用自动高亮显示后,如果希望高亮显示当前文件中某符号的用法,请选择该符号并按 Ctrl+Shift+F7。 这将高亮显示当前文件中该符号的所有用法。

更改用法高亮显示的背景色

  1. 设置 对话框(Ctrl+Alt+S )中,转到 编辑器 | 颜色方案 | 常规

  2. 在右侧选项中,展开 代码 节点并选择 插入符号下的标识符

  3. 背景 字段中,指定所需颜色并保存更改。

搜索基方法或方法的实现

搜索方法用法时,GoLand 会提示选择是要搜索基方法还是方法实现。

如果选中 记住,不再询问 复选框,GoLand 将不再显示提示,并使用所选搜索选项作为默认值。 如有需要,您可以恢复该提示。

  1. 设置 对话框(Ctrl+Alt+S )中,转到 编辑器 | 常规 | 智能键

  2. PHP 区域中,选中 查找方法用法时显示其他选项 复选框。

提高效率的提示

显示某目录的用法

  • 项目 工具窗口(视图 | 工具窗口 | 项目 )中,右键点击目录以查看该目录的使用位置。

    “查找用法”操作可在 Project 工具窗口中的上下文菜单中使用
最后修改日期: 2025年 9月 26日