# 搜索用法

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt).

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

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

Procedure: 在文件中搜索用法

* 在编辑器中，选择要查找的符号，IntelliJ IDEA 会自动高亮显示文件中找到的所有用法。 如果 [用法高亮](#disable-highlighting-usages)被禁用，请按 `Ctrl+Shift+F7` (Windows), `⌘ ⇧ F7` (macOS), `⌘ ⇧ F7` (IntelliJ IDEA Classic (macOS)), `⌘ ⌃ U` (macOS System Shortcuts), `Ctrl+Shift+F7` (XWin), `Ctrl+Shift+F7` (GNOME), `Ctrl+Shift+7` (KDE), `Ctrl+Shift+F7` (Emacs), `Ctrl+Shift+F7` (Sublime Text), `⌘ ⇧ F7` (Sublime Text (macOS)), `Alt+Shift+F11` (Visual Studio), `⌥ ⇧ F11` (Visual Studio (macOS)), `Ctrl+Shift+F7` (NetBeans), `Alt+Shift+O` (Eclipse), `Ctrl+Shift+F7` (Eclipse (macOS)) 来高亮文件中的所有用法。

![在文件中查找用法结果](https://resources.jetbrains.com/help/img/idea/2026.3/find_usages_in_file.png)

* 转到  `编辑 | 查找用法 | 在文件中查找用法`  `Ctrl+F7` (Windows), `⌘ F7` (macOS), `⌘ F7` (IntelliJ IDEA Classic (macOS)), `⌃ ⇧ U` (macOS System Shortcuts), `Ctrl+F7` (XWin), `Ctrl+F7` (GNOME), `Ctrl+7` (KDE), `Ctrl+F7` (Emacs), `Ctrl+F7` (Sublime Text), `⌘ F7` (Sublime Text (macOS)), `Alt+Shift+F11` (Visual Studio), `⌥ ⇧ F11` (Visual Studio (macOS)), `Ctrl+F7` (NetBeans), `Ctrl+Shift+G` (Eclipse), `⌘ ⇧ U` (Eclipse (macOS))。 IntelliJ IDEA 选择文件中的第一次使用出现。

![查找用法结果](https://resources.jetbrains.com/help/img/idea/2026.3/find_first_usage_occurrence.png)

使用 `Ctrl+F7` (Windows), `⌘ F7` (macOS), `⌘ F7` (IntelliJ IDEA Classic (macOS)), `⌃ ⇧ U` (macOS System Shortcuts), `Ctrl+F7` (XWin), `Ctrl+F7` (GNOME), `Ctrl+7` (KDE), `Ctrl+F7` (Emacs), `Ctrl+F7` (Sublime Text), `⌘ F7` (Sublime Text (macOS)), `Alt+Shift+F11` (Visual Studio), `⌥ ⇧ F11` (Visual Studio (macOS)), `Ctrl+F7` (NetBeans), `Ctrl+Shift+G` (Eclipse), `⌘ ⇧ U` (Eclipse (macOS))，您还可以高亮显示异常名称以及抛出异常的位置。

![突出异常](https://resources.jetbrains.com/help/img/idea/2026.3/highlight_exception_places.animated.gif)

使用 `F3` (Windows), `⌘ G` (macOS), `F3` (IntelliJ IDEA Classic (macOS)), `⌘ G` (macOS System Shortcuts), `F3` (XWin), `F3` (GNOME), `F3` (KDE), `F3` (Emacs), `F3` (Sublime Text), `⌘ G` (Sublime Text (macOS)), `F3` (Visual Studio), `F3` (Visual Studio (macOS)), `F3` (NetBeans), `Ctrl+K` (Eclipse), `⌘ K` (Eclipse (macOS)) 和 `Shift+F3` (Windows), `⌘ ⇧ G` (macOS), `⇧ F3` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ G` (macOS System Shortcuts), `Shift+F3` (XWin), `Shift+F3` (GNOME), `Shift+F3` (KDE), `Shift+F3` (Emacs), `Shift+F3` (Sublime Text), `⌘ ⇧ G` (Sublime Text (macOS)), `Shift+F3` (Visual Studio), `⇧ F3` (Visual Studio (macOS)), `Shift+F3` (NetBeans), `Ctrl+Shift+K` (Eclipse), `⌘ ⇧ K` (Eclipse (macOS)) 快捷键在高亮符号之间导航。

Procedure: 在项目中搜索用法

* 选择要查找其用法的符号，右键点击该符号，然后从其上下文菜单中选择  `查找用法` ，或按 `Alt+F7` (Windows), `⌥ F7` (macOS), `⌥ F7` (IntelliJ IDEA Classic (macOS)), `⌃ U` (macOS System Shortcuts), `Alt+F7` (XWin), `Alt+Shift+7` (GNOME), `Alt+Shift+7` (KDE), `Alt+F7` (Emacs), `Alt+F7` (Sublime Text), `⌥ F7` (Sublime Text (macOS)), `Shift+F12` (Visual Studio), `⇧ F12` (Visual Studio (macOS)), `Alt+F7` (NetBeans), `Ctrl+G` (Eclipse), `⌘ ⇧ G` (Eclipse (macOS))。

请在 [Find](find-tool-window.html) 工具窗口中检查结果。

如果您需要，您可以按文件、包、目录等分组( ![“分组依据”图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.show.svg))结果。

![查找工具窗口](https://resources.jetbrains.com/help/img/idea/2026.3/find_usages_tool_window.png)

要打开   查找用法  对话框，请点击 ![设置图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg)工具栏中的   查找  工具窗口，或按 `Ctrl+Alt+Shift+F7` (Windows), `⌘ ⌥ ⇧ F7` (macOS), `⌘ ⌥ ⇧ F7` (IntelliJ IDEA Classic (macOS)), `⌃ ⌥ ⇧ U` (macOS System Shortcuts), `Ctrl+Alt+Shift+7` (XWin), `Ctrl+Alt+Shift+7` (GNOME), `Ctrl+Alt+Shift+7` (KDE), `Ctrl+Alt+Shift+F7` (Emacs), `Ctrl+Alt+Shift+F7` (Sublime Text), `⌘ ⌥ ⇧ F7` (Sublime Text (macOS)), `Ctrl+Alt+Shift+F12` (Visual Studio), `⌘ ⌥ ⇧ F12` (Visual Studio (macOS)), `Ctrl+Alt+Shift+F7` (NetBeans), `Ctrl+Alt+Shift+F7` (Eclipse), `⌘ ⌥ ⇧ F7` (Eclipse (macOS))。

IntelliJ IDEA 会分析搜索结果，检测最常见的用法模式，并根据结构相似性将所有找到的用法归类到不同组中。 这些用法集群会显示在   预览   选项卡中。

您可以从列表中选择任何组节点，然后点击   显示相似用法  以查看结果。

![显示相似用法](https://resources.jetbrains.com/help/img/idea/2026.3/similar_usages.animated.gif)

要禁用此功能，请清除   在查找用法视图中启用相似用法集群   复选框，位于 [高级设置](advanced-settings.html#advanced_find_replace) 中。

在   查找   工具窗口中，您还可以使用   预览   区域来检查找到用法的位置，以查看方法的调用层次结构、字段的数据流等等。

![查找工具窗口预览区域](https://resources.jetbrains.com/help/img/idea/2026.3/find_tool_window_preview_area.png)

您可以使用   查找用法   操作，作为 [调用层次结构](viewing-structure-and-hierarchy-of-the-source-code.html) 操作的替代方案（ `Ctrl+Alt+H` (Windows), `⌃ ⌥ H` (macOS), `⌃ ⌥ H` (IntelliJ IDEA Classic (macOS)), `⌃ ⇧ H` (macOS System Shortcuts), `Ctrl+Alt+H` (XWin), `Ctrl+Alt+H` (GNOME), `Ctrl+Alt+H` (KDE), `Ctrl+Alt+H` (Emacs), `Ctrl+Alt+H` (Sublime Text), `⌃ ⌥ H` (Sublime Text (macOS)), `Ctrl+Alt+H` (Visual Studio), `⌃ ⌥ H` (Visual Studio (macOS)), `Ctrl+Alt+H` (NetBeans), `Ctrl+Alt+H` (Eclipse), `⌃ ⌥ H` (Eclipse (macOS))）。

![调用层次结构窗口](https://resources.jetbrains.com/help/img/idea/2026.3/call_hierarchy.png)

Procedure: 预览找到的用法的源代码

您有多种选项可以查看找到的用法的源代码。

1. 选择要查找其用法的符号，右键点击该符号，然后从其上下文菜单中选择  `查找用法` ，或按 `Alt+F7` (Windows), `⌥ F7` (macOS), `⌥ F7` (IntelliJ IDEA Classic (macOS)), `⌃ U` (macOS System Shortcuts), `Alt+F7` (XWin), `Alt+Shift+7` (GNOME), `Alt+Shift+7` (KDE), `Alt+F7` (Emacs), `Alt+F7` (Sublime Text), `⌥ F7` (Sublime Text (macOS)), `Shift+F12` (Visual Studio), `⇧ F12` (Visual Studio (macOS)), `Alt+F7` (NetBeans), `Ctrl+G` (Eclipse), `⌘ ⇧ G` (Eclipse (macOS))。

2. 在   查找   工具窗口中，点击 ![预览源代码](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.previewVertically.svg)   预览源代码   图标。

作为替代，您可以选择   跳转到源  ，如果您在找到的用途中调用上下文菜单，或   在拆分中显示  。 在这种情况下，包含结果使用情况的文件会在编辑器中打开。

Procedure: 在单独窗口中显示用法

您可以在一个单独的窗口中查看所选符号的用法，您可以将该窗口移动到屏幕的不同部分，以便快速导航。

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

2. 转到  `编辑 | 查找用法 | 显示代码中的用法编码信息`  `Ctrl+Alt+F7` (Windows), `⌘ ⌥ F7` (macOS), `⌘ ⌥ F7` (IntelliJ IDEA Classic (macOS)), `⌃ ⌥ U` (macOS System Shortcuts), `Ctrl+Alt+7` (XWin), `Ctrl+Alt+7` (GNOME), `Ctrl+Alt+7` (KDE), `Ctrl+Alt+F7` (Emacs), `Shift+F12` (Sublime Text), `⇧ F12` (Sublime Text (macOS)), `Alt+Shift+F12` (Visual Studio), `⌥ ⇧ F12` (Visual Studio (macOS)), `Ctrl+Alt+F7` (NetBeans), `Ctrl+Alt+F7` (Eclipse), `⌘ ⌥ F7` (Eclipse (macOS))。

![显示用法结果窗口](https://resources.jetbrains.com/help/img/idea/2026.3/show_usages.png)

用法窗口显示当前范围和用法总数。 如果您想快速切换到默认范围，请按 `Ctrl+Alt+F7` (Windows), `⌘ ⌥ F7` (macOS), `⌘ ⌥ F7` (IntelliJ IDEA Classic (macOS)), `⌃ ⌥ U` (macOS System Shortcuts), `Ctrl+Alt+7` (XWin), `Ctrl+Alt+7` (GNOME), `Ctrl+Alt+7` (KDE), `Ctrl+Alt+F7` (Emacs), `Shift+F12` (Sublime Text), `⇧ F12` (Sublime Text (macOS)), `Alt+Shift+F12` (Visual Studio), `⌥ ⇧ F12` (Visual Studio (macOS)), `Ctrl+Alt+F7` (NetBeans), `Ctrl+Alt+F7` (Eclipse), `⌘ ⌥ F7` (Eclipse (macOS))。

如果搜索结果包含太多条目，那么 IntelliJ IDEA 会显示前一百个找到的用法，并在窗口底部显示   更多用法  选项，您可以点击以显示另一百个用法，如此类推，直到搜索完成。

![更多用法](https://resources.jetbrains.com/help/img/idea/2026.3/more_usages.png)

使用窗口顶部的过滤器来显示或隐藏特定的搜索条目。

![显示用法：过滤器](https://resources.jetbrains.com/help/img/idea/2026.3/filter_usages.png)

您可以配置 IntelliJ IDEA 以在编辑器中显示 Java 代码符号的用法。 代码洞察让您专注于代码，并提供丰富的上下文信息和导航。

Procedure: 显示内联提示以供使用

1. 在   设置   对话框（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))），转到  `编辑器 | 内嵌提示` 。

2. 展开   Code Vision片段视觉化工具栏：Code Vision 点击 Code Vision   部分并选中   用法   复选框。

3. 请点击   OK   以保存更改。

当您返回编辑器中的代码时，IntelliJ IDEA将显示 Java 符号的用法。 您可以点击显示的提示，以在 [单独窗口](#find_usages_show_separate_window)中查看并导航到所需的用法。

![内嵌提示：用法](https://resources.jetbrains.com/help/img/idea/2026.3/inlay_hints_for_usages.png)

可以点击 !["设置"图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg) 以访问 [查找用法设置](find-usages-dialog.html)。

如果您在   相关问题   选项中选择  `设置 | 编辑器 | 内嵌提示` ，IntelliJ IDEA 将通过内嵌提示警告您代码中与具有外部使用的类或方法的签名更改相关的问题。 此功能同样适用于字段。

![嵌入提示](https://resources.jetbrains.com/help/img/idea/2026.3/related_problems.png)

可以点击相关问题的嵌入提示，并在 [查找](find-tool-window.html) 工具窗口中检查找到的问题。

![查找工具窗口](https://resources.jetbrains.com/help/img/idea/2026.3/Find_problems_tool_window.png)

Procedure: 查看最近使用的搜索结果

IntelliJ IDEA 会记住您的   查找用法  结果，因此您不需要再次运行该操作。

* 在主菜单中，前往  `编辑 | 查找 | 最近查找用法​` 然后选择使用查询。

Procedure: 管理查找用法的范围

有时，您可能希望仅在项目的某些文件或库中查找用法。

1. 按 `Ctrl+Alt+Shift+F7` (Windows), `⌘ ⌥ ⇧ F7` (macOS), `⌘ ⌥ ⇧ F7` (IntelliJ IDEA Classic (macOS)), `⌃ ⌥ ⇧ U` (macOS System Shortcuts), `Ctrl+Alt+Shift+7` (XWin), `Ctrl+Alt+Shift+7` (GNOME), `Ctrl+Alt+Shift+7` (KDE), `Ctrl+Alt+Shift+F7` (Emacs), `Ctrl+Alt+Shift+F7` (Sublime Text), `⌘ ⌥ ⇧ F7` (Sublime Text (macOS)), `Ctrl+Alt+Shift+F12` (Visual Studio), `⌘ ⌥ ⇧ F12` (Visual Studio (macOS)), `Ctrl+Alt+Shift+F7` (NetBeans), `Ctrl+Alt+Shift+F7` (Eclipse), `⌘ ⌥ ⇧ F7` (Eclipse (macOS)) 打开 [查找用法](find-usages-dialog.html) 对话框。

2. 在   查找用法   对话框的   范围   字段中，选择搜索作用域。 例如，您可以仅在   打开文件   中搜索用法，或者仅在   项目测试文件   中搜索。

![查找用法对话框（更改范围）](https://resources.jetbrains.com/help/img/idea/2026.3/find_usages_dialog_scope.png)

您还可以设置自定义 [作用域](settings-scopes.html)，方法是点击 ![省略号图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg)。 例如，您可以创建一个自定义 scope 以排除某些文件，例如测试文件，从用法搜索中。 设置新的作用域后，点击   查找  。

如果 IntelliJ IDEA 没有返回任何结果，将显示一条消息，建议您选择更多选项。

![未找到用法弹出窗口](https://resources.jetbrains.com/help/img/idea/2026.3/no_usages_found.png)

可以点击链接或按 `Ctrl+Alt+Shift+F7` (Windows), `⌘ ⌥ ⇧ F7` (macOS), `⌘ ⌥ ⇧ F7` (IntelliJ IDEA Classic (macOS)), `⌃ ⌥ ⇧ U` (macOS System Shortcuts), `Ctrl+Alt+Shift+7` (XWin), `Ctrl+Alt+Shift+7` (GNOME), `Ctrl+Alt+Shift+7` (KDE), `Ctrl+Alt+Shift+F7` (Emacs), `Ctrl+Alt+Shift+F7` (Sublime Text), `⌘ ⌥ ⇧ F7` (Sublime Text (macOS)), `Ctrl+Alt+Shift+F12` (Visual Studio), `⌘ ⌥ ⇧ F12` (Visual Studio (macOS)), `Ctrl+Alt+Shift+F7` (NetBeans), `Ctrl+Alt+Shift+F7` (Eclipse), `⌘ ⌥ ⇧ F7` (Eclipse (macOS)) 再次打开   查找用法   对话框，并为搜索设置新的作用域。

Procedure: 禁用自动高亮显示用法

当您将文本光标放置在一个符号上时，IDE 会高亮显示该符号在当前文件中的所有用法。

> **Note:**
> 在省电模式下(  `文件 | 节能模式` )，禁用用法高亮显示。

如果有必要，您可以禁用自动高亮。

1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `编辑器 | 代码编辑` 。

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

当自动高亮功能被禁用时，如果您想在当前文件中高亮显示一个符号的用法，请选择此符号并按下 `Ctrl+Shift+F7` (Windows), `⌘ ⇧ F7` (macOS), `⌘ ⇧ F7` (IntelliJ IDEA Classic (macOS)), `⌘ ⌃ U` (macOS System Shortcuts), `Ctrl+Shift+F7` (XWin), `Ctrl+Shift+F7` (GNOME), `Ctrl+Shift+7` (KDE), `Ctrl+Shift+F7` (Emacs), `Ctrl+Shift+F7` (Sublime Text), `⌘ ⇧ F7` (Sublime Text (macOS)), `Alt+Shift+F11` (Visual Studio), `⌥ ⇧ F11` (Visual Studio (macOS)), `Ctrl+Shift+F7` (NetBeans), `Alt+Shift+O` (Eclipse), `Ctrl+Shift+F7` (Eclipse (macOS))。 这将高亮显示当前文件中该符号的所有用法。

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

1. 在   设置   对话框（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))），转到  `编辑器 | 配色方案 | 常规` 。

2. 从右侧的选项中，打开  `代码`  节点并选择   光标下的标识符  。

3. 请在   背景   字段中指定您需要的颜色并保存更改。

