# 搜索用法

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

通过   查找用法  操作，您可以在整个代码库中搜索代码元素的引用。

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

Procedure: 在文件中搜索用法

* 将插入符号放在一个符号上，然后按 `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)), `⌘ F7` (Xcode), `Alt+Shift+F11` (Visual Studio), `⌥ ⇧ F11` (Visual Studio (macOS)), `Ctrl+Shift+F7` (ReSharper), `⌘ ⇧ F7` (ReSharper (macOS)), `Ctrl+F7` (QtCreator), `⌘ F7` (QtCreator (macOS)), `Ctrl+F7` (NetBeans), `Ctrl+Shift+G` (Eclipse), `⌘ ⇧ U` (Eclipse (macOS))。 CLion 显示文件中该符号的所有用法。

![在文件中查找用法](https://resources.jetbrains.com/help/img/idea/2026.3/cl_findusages_infile.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)), `⌘ F7` (Xcode), `Alt+Shift+F11` (Visual Studio), `⌥ ⇧ F11` (Visual Studio (macOS)), `Ctrl+Shift+F7` (ReSharper), `⌘ ⇧ F7` (ReSharper (macOS)), `Ctrl+F7` (QtCreator), `⌘ F7` (QtCreator (macOS)), `Ctrl+F7` (NetBeans), `Ctrl+Shift+G` (Eclipse), `⌘ ⇧ U` (Eclipse (macOS))。 CLion 选择文件中的第一次使用出现。

使用 `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)), `⌘ G` (Xcode), `F3` (Visual Studio), `F3` (Visual Studio (macOS)), `F3` (ReSharper), `F3` (ReSharper (macOS)), `F3` (QtCreator), `⌘ G` (QtCreator (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)), `⌘ ⇧ G` (Xcode), `Shift+F3` (Visual Studio), `⇧ F3` (Visual Studio (macOS)), `Shift+F3` (ReSharper), `⇧ F3` (ReSharper (macOS)), `Shift+F3` (QtCreator), `⌘ ⇧ G` (QtCreator (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)), `⌥ F7` (Xcode), `Shift+F12` (Visual Studio), `⇧ F12` (Visual Studio (macOS)), `Alt+F7` (ReSharper), `⌥ F7` (ReSharper (macOS)), `Ctrl+Shift+U` (QtCreator), `⌘ ⇧ U` (QtCreator (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/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)), `⌘ ⌥ ⇧ F7` (Xcode), `Ctrl+Alt+Shift+F12` (Visual Studio), `⌘ ⌥ ⇧ F12` (Visual Studio (macOS)), `Alt+Shift+F7` (ReSharper), `⌥ ⇧ F17` (ReSharper (macOS)), `Ctrl+Alt+Shift+F7` (QtCreator), `⌘ ⌥ ⇧ F7` (QtCreator (macOS)), `Ctrl+Alt+Shift+F7` (NetBeans), `Ctrl+Alt+Shift+F7` (Eclipse), `⌘ ⌥ ⇧ F7` (Eclipse (macOS))。

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

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

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

在   查找   工具窗口中，您可以使用   预览   ![预览用法按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.previewDetails.svg) 区域检查找到用法的位置，以及 [调用层次结构](analyzing-applications.html)。

![查找工具窗口预览区域](https://resources.jetbrains.com/help/img/idea/2026.3/cl_find_tool_window_preview_area.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)), `⌥ F7` (Xcode), `Shift+F12` (Visual Studio), `⇧ F12` (Visual Studio (macOS)), `Alt+F7` (ReSharper), `⌥ F7` (ReSharper (macOS)), `Ctrl+Shift+U` (QtCreator), `⌘ ⇧ U` (QtCreator (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)), `⌘ ⌥ F7` (Xcode), `Alt+Shift+F12` (Visual Studio), `⌥ ⇧ F12` (Visual Studio (macOS)), `Ctrl+Alt+F7` (ReSharper), `⌘ ⌥ F7` (ReSharper (macOS)), `Ctrl+Alt+F7` (QtCreator), `⌘ ⌥ F7` (QtCreator (macOS)), `Ctrl+Alt+F7` (NetBeans), `Ctrl+Alt+F7` (Eclipse), `⌘ ⌥ F7` (Eclipse (macOS))。

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

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

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

用法窗口显示在当前作用域内找到的结果。 要快速切换到默认作用域，请再次按相同的快捷键 `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)), `⌘ ⌥ F7` (Xcode), `Alt+Shift+F12` (Visual Studio), `⌥ ⇧ F12` (Visual Studio (macOS)), `Ctrl+Alt+F7` (ReSharper), `⌘ ⌥ F7` (ReSharper (macOS)), `Ctrl+Alt+F7` (QtCreator), `⌘ ⌥ F7` (QtCreator (macOS)), `Ctrl+Alt+F7` (NetBeans), `Ctrl+Alt+F7` (Eclipse), `⌘ ⌥ F7` (Eclipse (macOS))。

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

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

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

Procedure: 管理 Find Usages 的作用域

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

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)), `⌘ ⌥ ⇧ F7` (Xcode), `Ctrl+Alt+Shift+F12` (Visual Studio), `⌘ ⌥ ⇧ F12` (Visual Studio (macOS)), `Alt+Shift+F7` (ReSharper), `⌥ ⇧ F17` (ReSharper (macOS)), `Ctrl+Alt+Shift+F7` (QtCreator), `⌘ ⌥ ⇧ F7` (QtCreator (macOS)), `Ctrl+Alt+Shift+F7` (NetBeans), `Ctrl+Alt+Shift+F7` (Eclipse), `⌘ ⌥ ⇧ F7` (Eclipse (macOS)) 打开   查找用法   对话框。

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

![查找用法对话框](https://resources.jetbrains.com/help/img/idea/2026.3/cl_find_usages_dialog.png)

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

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

![未找到用法弹出窗口](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)), `⌘ ⌥ ⇧ F7` (Xcode), `Ctrl+Alt+Shift+F12` (Visual Studio), `⌘ ⌥ ⇧ F12` (Visual Studio (macOS)), `Alt+Shift+F7` (ReSharper), `⌥ ⇧ F17` (ReSharper (macOS)), `Ctrl+Alt+Shift+F7` (QtCreator), `⌘ ⌥ ⇧ F7` (QtCreator (macOS)), `Ctrl+Alt+Shift+F7` (NetBeans), `Ctrl+Alt+Shift+F7` (Eclipse), `⌘ ⌥ ⇧ 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)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))) 中，前往  `编辑器 | 颜色方案 | 常规` 。

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

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

## See also

### 参考

[高级设置](advanced-settings.html)

