CLion教程-查找用法

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

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

在文件中查找用法

在符号上放置光标，然后按下Ctrl+F7。CLion将显示文件中该符号的所有用法。
从主菜单中选择“编辑” | “查找用法” | “在文件中查找用法”Ctrl+F7。CLion会选择文件中第一个使用情况。

使用F3和ShiftF3快捷键在突出显示的符号之间导航。

您还可以使用快捷键和快捷键在用法之间导航。

在项目中查找用法

选择要查找用法的符号，右键单击该符号，从其上下文菜单中选择“查找用法”或按下Alt+F7。
- 在查找工具窗口中查看结果。
- 如果需要，您可以通过文件、包、目录等对结果进行分组（）。
- 要打开“查找用法”对话框，请单击工具栏上的或按下CtrlAltShiftF7。
- CLion分析搜索结果，检测最常见的用法模式，并基于结构相似性将所有找到的用法分类成群组。这些用法集群出现在“预览”选项卡中。

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

要禁用此功能，请取消选中“查找用法视图中启用相似用法聚类”（位于高级设置中）。

在“查找”工具窗口中，您可以使用预览区域（)来检查找到用法的位置，以及调用层次结构。

预览找到用法的源代码

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

选择要查找用法的符号，右键单击该符号，从其上下文菜单中选择“查找用法”或按下Alt+F7。
在“查找”工具窗口中，单击“预览源代码”图标。
或者，您还可以在找到的用法上右键单击，选择“跳转到源代码”，或选择“显示拆分”。在这种情况下，结果使用处的文件会在编辑器中打开。

在单独的窗口中显示用法

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

在编辑器中，选择要查看用法的符号。
从主菜单中选择“编辑” | “查找用法” | “在代码中显示用法”CtrlAltF7。
- 如果搜索结果有太多条目，则CLion会显示前一百条找到的用法，以及窗口底部的“更多用法”选项，您可以单击该选项以显示另外一百条用法，依此类推，直到搜索完成。
- 使用窗口顶部的过滤器来显示或隐藏某些搜索条目。

用法窗口显示在当前范围内找到的结果。要快速切换到默认范围，请再次按下相同的快捷键CtrlAltF7。

查看最近的用法搜索结果

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

从主菜单中选择“编辑” | “查找” | “最近的用法搜索”，然后选择使用查询。

管理“查找用法”的范围

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

按下CtrlAltShiftF7打开“查找用法”对话框。
在“查找用法”对话框中，在“范围”字段中选择要搜索的范围。例如，您可以仅在打开的文件或项目测试文件中搜索用法。
- 您还可以通过单击来设置自定义范围。例如，您可以创建一个自定义范围，以从用法搜索中排除某些文件，如测试文件。完成新范围的设置后，单击“查找”。
如果CLion没有返回任何结果，它会显示一条消息，建议您选择更多选项。
- 您可以跟随链接或按下CtrlAltShiftF7再次打开“查找用法”对话框，并为搜索设置新范围。

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

在“设置”对话框中（CtrlAlt+S），转到“编辑器” | “颜色方案” | “常规”。
在右侧的选项中，打开“代码”节点，并在“光标下的标识符”下选择“背景”。
在“背景”字段中指定所需的颜色，并保存更改。

使用 Clangd 索引器改进“查找用法”

目前，Clangd 索引器不适用于WSL工具链（CPP-32070）。

CLion集成了用于C++代码的两个语言引擎，即内置引擎和基于Clangd的引擎。默认情况下，“查找用法”由内置引擎提供支持，但是，它带来了以下不足之处：

在查找可以用于隐式转换的构造函数和隐式转换运算符时，“查找用法”不准确。
在某些情况下，“查找用法”的性能可能不令人满意。

这两个问题都可以通过启用基于Clangd的索引器来解决。

启用 Clangd 索引器

转到“设置” | “高级设置”。
导航到“Clangd”部分，并设置“使用基于Clangd的索引器”复选框：
重新启动 CLion。

检查索引器状态和内存消耗

启用索引器后，状态栏中将显示一个圆形指示器。

绿色表示索引器已准备就绪。在此状态下，搜索是即时执行的，无论项目中有多少符号用法。这在整个项目中使用的符号或运算符（如=,+,-,*）中特别明显。
黄色表示索引器正在进行更新。
灰色表示索引器已暂停。
您可以将鼠标悬停在指示器上，以查看内存消耗：

重新构建或暂停索引器

如果索引器似乎失效，请单击指示器，然后选择“重新启动”：
为了暂停索引器以释放其正在使用的CPU和内存，单击指示器，然后选择“暂停”。

调整索引器设置

单击索引器指示器，然后选择“设置”：

启用模块 - 关闭以避免潜在的崩溃（可能会导致减速）。
启用动态索引 - 打开以提高最近打开的文件中的搜索速度。
在工具栏中显示进度 - 启用索引器的进度条。

单击“应用”。