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和内存,单击指示器,然后选择“暂停”。
调整索引器设置
单击索引器指示器,然后选择“设置”:
- 启用模块 - 关闭以避免潜在的崩溃(可能会导致减速)。
- 启用动态索引 - 打开以提高最近打开的文件中的搜索速度。
- 在工具栏中显示进度 - 启用索引器的进度条。
单击“应用”。