CLion 2025.2 Help

启用/禁用和抑制检查

有些检查可能会报告您当前不希望看到的问题。 在这种情况下,您可以禁用或抑制它们。

禁用检查

当您 禁用检查时,您将其关闭。 这意味着代码分析引擎将停止在项目文件中搜索此检查旨在检测的问题。 请注意,当您禁用检查时,您是在当前 检查配置文件中禁用它;它在其他配置文件中仍然启用。

在 CLion 中,大多数检查都可以禁用。 但是,一些检查将会不管设置如何继续高亮显示您的代码。 例如,语法错误始终会被高亮显示。

在设置中禁用检查

  1. 按下 Ctrl+Alt+S 打开设置,然后选择 编辑器|检查

  2. 找到您想要禁用的检查,并清除其旁边的复选框。

    启用检查
  3. 应用更改并关闭对话框。

从编辑器禁用检查

  1. 将插入符号放在高亮行上,然后按 Alt+Enter (或点击 显示上下文操作图标 )以调用可用上下文操作列表。

  2. 点击 更多操作按钮 检查旁边的按钮,然后选择 禁用检查

    在编辑器中禁用检查

从问题工具窗口禁用检查

  1. 检查结果 选项卡的 问题 工具窗口中(在您运行代码分析后显示),右键点击您想要禁用的检查并选择 禁用检查

  2. 点击工具栏上的 视图选项按钮 按钮,然后选择 筛选已解决的项目 以隐藏已禁用检查的警报。

禁止检查

当您 抑制检查时,代码分析引擎不会在特定代码片段(文件、语句、函数或行)中高亮显示该检查发现的问题。

在 CLion 中,大多数检查可以被抑制。 然而,有些检查没有此选项。 例如,语法错误始终会在编辑器中高亮显示,无论设置如何。

禁止从编辑器中检查

  1. 将文本光标放置在高亮行并按 Alt+Enter (或点击 意图操作 图标 使用意图操作)。

  2. 点击您想要抑制的检查旁边的 按钮,并根据所需作用域选择一个操作。

    在编辑器中抑制检查

对于 C/C++ 代码,CLion 使用 #pragma clang diagnostic 来抑制检查。 例如,当您抑制 Clang-Tidy检查之一时, modernize-avoid-bind ,对于选定的函数,以下代码会出现在声明的上方和下方:

为函数抑制检查

Clang-Tidy 检查具有额外的 为行抑制 选项,该选项会添加 // NOLINT注释,强制 Clang-Tidy 忽略当前行:

为行抑制检查

要重新启用被抑制的检查,请删除 #pragma 行或 // NOLINT 注释。

禁用突出显示,但保留修复

检查具有 严重性 ,根据这些严重性,它们在编辑器中突出显示代码问题。 您可以在不打开设置的情况下快速禁用检查的代码高亮显示。 在这种情况下,检查保持启用并提供修复,但严重性会更改为 无高亮显示(修复可用)

  1. 将文本光标放置在编辑器中由检查突出显示的代码元素处,然后按 Alt+Enter

    会打开一个可用修复和上下文操作的列表。 找到标记为 意图操作图标 的检查修复。

  2. 点击修复旁边的 按钮以打开检查选项并选择 禁用高亮显示,保留修正

检查选项上方写有您正在更改严重性的检查名称。

如果您想恢复高亮,请按 Ctrl+Alt+S 打开 IDE 设置并选择 编辑器|检查。 在列表中找到所需的检查并根据需要更改其严重性。 如需了解详情,请参阅 更改所有作用域内的检查严重性

更改文件的高亮级别

  • 默认情况下,CLion 会突出显示所有检测到的代码问题。 将鼠标悬停在编辑器右上角的小部件上,然后从 高亮显示 列表中选择另一级别:

    • :关闭高亮显示。

    • 语法 :仅突出语法问题。

    • 所有问题 :(默认)突出显示语法问题和检查发现的问题。

  • 您还可以从主菜单中更改突出显示级别。 选择或按 Ctrl+Alt+Shift+H

最后修改日期: 2025年 9月 26日