CLion教程-运行检查

CLion会分析在编辑器中打开的文件,并在您输入时突出显示有问题的代码。此外,您还可以在所选的文件范围上手动运行必要的检查或一组检查。在这种情况下,您将获得有关文件中检测到的所有问题的综合报告。
即时分析当前文件
IDE会持续检查您的代码并查找问题。编辑器右上角的小部件显示了在当前文件中检测到的每个严重程度的问题数量:
该小部件具有简化视图。要启用它,将鼠标悬停在小部件上,单击
,然后选择紧凑视图。
单击小部件以打开在问题工具窗口的文件选项卡中列出的问题列表。您还可以通过选择View | Tool Windows | Problems或按Alt + 6来访问问题工具窗口。
对于每个问题,您可以按Alt + Enter或单击 来查看建议的快速修复。您还可以按F4或在工具窗口中双击问题以跳转到编辑器中的相应行。
或者,单击 以在工具窗口中查看和修复问题。
滚动条中的颜色条还标记了检测到的代码问题,并帮助您快速访问相应的行,而无需滚动文件。将鼠标悬停在条上的标记上,以在工具提示中查看检测到的问题。单击标记以跳转到相应的行。
导航到检测到的问题
您可以通过单击小部件中的 或
,或按F2或Shift + F2来跳转到文件中的一个突出显示的问题。默认情况下,IDE将根据其严重程度导航您至问题:错误 > 警告 > 弱警告 > 服务器问题 > 拼写错误。
您可以配置CLion,使其无论严重性如何,都带您浏览问题。将鼠标悬停在编辑器右上角的小部件上,单击 ,选择“下一个错误”操作(F2)依次遍历,并启用“所有问题”。
手动运行检查
某些检查需要全局代码分析,这就是为什么它们在编辑器中被禁用的原因。这些检查列在Settings | Editor | Inspections中。单击 并选择“仅显示批处理模式检查”。
如果要获得所有检测到的问题的完整报告,请手动运行检查。
运行所有检查
- 从主菜单中选择Code | Inspect Code。
- 选择要分析的文件范围。
单击图标以配置新的范围。
选择要应用的检查配置文件。
- 若要创建新配置文件或修改现有配置文件之一,请单击Configure。
- 若要创建新配置文件或修改现有配置文件之一,请单击Configure。
- 单击“分析”以开始分析。
- 在问题视图的专用选项卡中查找结果:
指定检查范围对话框
项目 | 描述 |
---|---|
整个项目 | 检查整个项目。 |
模块 <name> | 检查当前在项目工具窗口中选定的模块。 |
文件 <name> | 检查当前在项目工具窗口中选定的文件或在编辑器中打开的文件。 |
选定的文件 | 检查当前在项目工具窗口中选定的文件。 |
未提交的文件 | 仅适用于受版本控制的项目。只检查尚未提交到版本控制系统的文件。 |
目录 | 检查当前在项目工具窗口中选定的目录。 |
自定义范围 | 检查自定义文件范围。从列表中选择预定义的范围,或单击 |
包括测试源 | 检查分析范围中包括的测试源。 |
检查注入的代码 | 检查嵌入在您的代码中的其他语言的代码片段。 |
检查配置文件 | 选择要用于检查代码的配置文件。如果所需配置文件不在列表中,请单击Configure并创建新配置文件。 |
运行单个检查
运行单个检查在您想要跟踪特定问题时非常有用。如果在文件中找到警告,您可以检查整个项目或必要的文件范围,以确保代码库中没有更多的这种警告。
- 从主菜单中选择Code | Analyze Code | Run Inspection by Name…或按Ctrl + Alt + Shift + 0,I。
在弹出窗口中键入检查的名称。使用CamelHumps来匹配驼峰命名法单词和带有单词首字母的空格。建议列表将显示与您的搜索请求匹配的检查。
- 如果您不确定是否选择了正确的检查,您可以查看其描述。要这样做,请在弹出窗口中选择检查,然后按Ctrl + 0,Q。
- 双击要检查的项目以打开其设置。
在打开的对话框中,选择要分析的文件范围。
- “文件掩码”选项可帮助您缩小要检查的文件数量。
选择复选框并指定与要分析的文件名称匹配的字符和通配符模式。使用逗号分隔多个文件掩码。
- “文件掩码”选项可帮助您缩小要检查的文件数量。
某些检查可能具有额外的选项,您将被提示配置这些选项。
- 这些设置仅在此运行中应用,不会影响当前配置文件中此检查的配置。
- IDE将在问题工具窗口的专用选项卡中显示检查结果。在那里,您可以查看并修复检测到的问题。
在提交到Git之前分析代码
如果您的项目受Git或Mercurial版本控制,您可以配置IDE在提交之前分析已修改的文件。
- 按Ctrl + 0,K或从主菜单中选择Git | Commit。
- 在提交工具窗口中,单击
,在“提交检查”区域中选择“分析代码”复选框。
- 单击“选择配置文件”并选择要从中运行检查的所需检查配置文件。
单击“提交”。
- CLion通过运行所选配置文件中的检查来分析已修改文件中的代码。
- 如果检测到任何错误或警告,您将看到一个通知。
- 在通知中,单击“查看代码分析”以查看消息工具窗口中检测到的问题列表。单击“忽略”以提交您的更改,而不修复检测到的问题。
离线运行检查
除了从IDE中运行代码检查外,您还可以在不运行CLion的情况下从命令行启动检查。检查结果将存储在XML文件中。
更改范围的顺序
默认情况下,所有已启用的代码检查会分析项目中的所有文件。根据您的需求,您可以在不同设置的文件范围中运行相同的检查,具有不同的设置。
如果一个文件包含在两个或多个范围中,并且您在这些范围中启用了一个检查,CLion将根据范围列表中的顺序处理它们 - 最上面的范围将具有最高的优先级,因此将首先分析它们。
- 在设置对话框中(Ctrl + Alt + 0,S),选择Editor | Inspections。
- 从列表中选择任何检查。
- 从“All Scopes”列表中选择“编辑范围顺序”。
- 选择所需的范围,并使用
和
将其上下移动。
- 如果需要,创建新范围。要这样做,单击
(Edit Scopes),指定范围设置,并选择要包含在其中的文件和文件夹。