# 运行检查

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

CLion [分析编辑器中打开的文件中的代码](null) 并在您输入时高亮显示有问题的代码。 此外，您可以在选定的文件作用域内 [手动](#run-inspections-manually)运行必要的检查或一组检查。 在这种情况下，您将获得一个有关文件中检测到的所有问题的综合报告。

## 当前文件的即时分析

IDE 会持续检查您的代码并查找问题。 当 CLion 分析代码时，会使用当前所选 [检查配置文件](customizing-profiles.html)中定义的检查。 编辑器右上角的小组件显示当前文件中检测到的每个 [严重性](configuring-inspection-severities.html)的问题数量：

![检查小部件](https://resources.jetbrains.com/help/img/idea/2026.3/ws_inspection-widget.png)

> **Tip:**
> 小部件具有简化视图。 要启用它，请将鼠标悬停在小部件上，点击 ![更多 按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.more.svg)，然后选择   紧凑视图  。
>
>
>
> ![问题小部件的紧凑视图](https://resources.jetbrains.com/help/img/idea/2026.3/cl_problems_compactview.png)

点击小部件以在   文件  选项卡中的 [问题工具窗口](problems-tool-window.html)中打开问题列表。 您还可以通过选择  `视图 | 工具窗口 | 问题` 或按 `Alt+6` (Windows), `⌘ 6` (macOS), `⌘ 6` (IntelliJ IDEA Classic (macOS)), `⌘ 6` (macOS System Shortcuts), `Alt+6` (XWin), `Alt+6` (GNOME), `Alt+6` (KDE), `Alt+6` (Emacs), `Alt+6` (Sublime Text), `⌘ 6` (Sublime Text (macOS)), `Alt+6` (Xcode), `Alt+6` (Visual Studio), `⌘ 6` (Visual Studio (macOS)), `Alt+6` (ReSharper), `⌘ 6` (ReSharper (macOS)), `Alt+1` (QtCreator), `⌘ 1` (QtCreator (macOS)), `Alt+6` (NetBeans), `Alt+6` (Eclipse), `⌘ 6` (Eclipse (macOS))来访问   问题  工具窗口。

![在工具窗口中查看问题列表](https://resources.jetbrains.com/help/img/idea/2026.3/cl_problems_in_tw.png)

对于每个问题，您可以通过按 `Alt+Enter` (Windows), `⌥ ⏎` (macOS), `⌥ ⏎` (IntelliJ IDEA Classic (macOS)), `⌥ ⏎` (macOS System Shortcuts), `Alt+Enter` (XWin), `Alt+Enter` (GNOME), `Alt+Enter` (KDE), `Alt+Enter` (Emacs), `Alt+Enter` (Sublime Text), `⌥ ⏎` (Sublime Text (macOS)), `⌥ ⏎` (Xcode), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (macOS)), `Alt+Enter` (ReSharper), `⌥ ⏎` (ReSharper (macOS)), `Alt+Enter` (QtCreator), `⌥ ⏎` (QtCreator (macOS)), `Alt+Enter` (NetBeans), `Ctrl+1` (Eclipse), `⌘ 1` (Eclipse (macOS)) 或点击 ![显示快速修复](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.codeInsight.intentionBulb.svg) 查看建议的快速修复。 要跳转到编辑器中的相应行，请按 `F4` (Windows), `⌘ ↓` (macOS), `F4` (IntelliJ IDEA Classic (macOS)), `F4` (macOS System Shortcuts), `F4` (XWin), `F4` (GNOME), `F4` (KDE), `F4` (Emacs), `F4` (Sublime Text), `F4` (Sublime Text (macOS)), `⌘ ↓` (Xcode), `F4` (Visual Studio), `⌘ ↓` (Visual Studio (macOS)), `F4` (ReSharper), `⌘ ↓` (ReSharper (macOS)), `F4` (QtCreator), `F4` (QtCreator (macOS)), `F4` (NetBeans), `F12` (Eclipse), `F3` (Eclipse (macOS))或双击工具窗口中的问题。

点击 ![打开编辑器预览](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.previewVertically.svg)即可在工具窗口中查看并修复问题。

滚动条中的颜色条还标记了检测到的代码问题，并帮助您快速访问相应的行，而无需滚动文件。 将鼠标悬停在条纹上的标记上，以在工具提示中查看检测到的问题。 点击标记以跳转到对应的行。

![即时代码分析结果](https://resources.jetbrains.com/help/img/idea/2026.3/cl_codeanalysis_file.png)

### 导航至检测到的问题

您可以通过点击挂件中的 ![下一个高亮错误按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.findAndShowNextMatches.svg) ![下一个高亮错误按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.findAndShowPrevMatches.svg)或按 `F2` (Windows), `F2` (macOS), `F2` (IntelliJ IDEA Classic (macOS)), `⌃ Comma` (macOS System Shortcuts), `F2` (XWin), `F2` (GNOME), `F2` (KDE), `F2` (Emacs), `F2` (Sublime Text), `F2` (Sublime Text (macOS)), `⌘ Quote` (Xcode), `Alt+Page Down` (Visual Studio), `⌥ Page ↓` (Visual Studio (macOS)), `F12` (ReSharper), `⌥ Page ↓` (ReSharper (macOS)), `F6` (QtCreator), `F6` (QtCreator (macOS)), `F2` (NetBeans), `F2` (Eclipse), `⌘ .` (Eclipse (macOS))或 `Shift+F2` (Windows), `⇧ F2` (macOS), `⇧ F2` (IntelliJ IDEA Classic (macOS)), `⌃ ⇧ Comma` (macOS System Shortcuts), `Shift+F2` (XWin), `Shift+F2` (GNOME), `Shift+F2` (KDE), `Shift+F2` (Emacs), `Shift+F2` (Sublime Text), `Shift+F2` (Sublime Text (macOS)), `⌘ ⇧ Quote` (Xcode), `Alt+Page Up` (Visual Studio), `⌥ Page ↑` (Visual Studio (macOS)), `Shift+F12` (ReSharper), `⇧ F12` (ReSharper (macOS)), `Shift+F6` (QtCreator), `⇧ F6` (QtCreator (macOS)), `Shift+F2` (NetBeans), `Shift+F1` (Eclipse), `⌘ ⇧ .` (Eclipse (macOS))相应地在文件中的一个高亮问题与另一个之间跳转。 默认情况下，IDE 会根据问题的 [严重性](configuring-inspection-severities.html)导航您：错误＞警告＞弱警告＞服务器问题＞拼写错误。

您可以配置 CLion 引导您逐一解决问题，无论其严重程度如何。 将鼠标悬停在编辑器右上角的小部件上，点击 ![更多 按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.more.svg)，选择   “下一个错误”操作（F2）进行  ，并启用   所有问题  。

![配置高亮行之间的导航](https://resources.jetbrains.com/help/img/idea/2026.3/cl_navigate_inspection_lines.png)

## 手动运行检查

某些检查需要全局代码分析，所以它们在编辑器中被禁用。 这些检查列出了  `设置 | 编辑器 | 检查` 。 点击 ![筛选检查](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.filter.svg)并选择   仅显示批处理模式检查  。

如果您想获得代码中所有问题的完整报告，请手动运行检查。 在这种情况下，IDE 会运行 您 的 [inspection profile](customizing-profiles.html) 中启用的所有检查，并在专用的工具窗口中显示结果。 完成分析所需的时间取决于启用的检查数量和分析作用域的大小。

Procedure: 运行所有检查

1. 在主菜单中，进入  `代码 | 检查代码…` .

2. 请选择您要分析的 [文件作用域](#Specify-inspection-scope)。

点击 ![“浏览”按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg) 图标以配置新的作用域。

3. 请选择您要应用的 [inspection profile](customizing-profiles.html)。

要创建新配置文件或修改现有配置文件之一，请点击   配置…  。

![指定检查作用域对话框](https://resources.jetbrains.com/help/img/idea/2026.3/cl_inspections_scope_dialog.png)

4. 点击   分析  以开始分析。

5. 在 [问题](problems-tool-window.html)视图的专用选项卡中找到结果：

![检查代码结果](https://resources.jetbrains.com/help/img/idea/2026.3/cl_inspections_run_results.png)

### 指定检测作用域对话框

|  项  |  描述  |
| --- | --- |
|    整个项目    |  检查整个项目。  |
|    模块 <name>    |  检查当前在   项目  工具窗口( `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `⌘ 1` (Xcode), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Alt+1` (ReSharper), `⌘ 1` (ReSharper (macOS)), `Alt+X` (QtCreator), `⌃ X` (QtCreator (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS)))中选中的模块。  |
|    文件<名称>    |  检查当前在   项目  工具窗口中选择或在编辑器中打开的文件。  |
|    选定的文件    |  检查当前在   项目  工具窗口中选择的文件。  |
|    未提交的文件    |     该作用域仅适用于版本控制下的项目。       仅检查尚未提交到版本控制系统的文件。     |
|    目录    |  检查当前在   项目  工具窗口中选择的目录。  |
|    自定义范围    |     检查自定义文件作用域。 从列表中选择一个预定义作用域，或点击 ![“浏览”按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg)，并在打开的 [Scopes 对话框](settings-scopes.html)中定义作用域。      > **Tip:** > 使用特殊的 [语言](scope-language-syntax-reference.html)来定义作用域。    |
|    包含测试源    |  检查包含在分析作用域内的测试源文件。  |
|    检查注入代码    |  检查嵌入在您的代码中的 [其它语言的代码片段](using-language-injections.html)。  |
|    检查配置文件    |     请选择一个您要用于检查代码的 [profile](customizing-profiles.html)。       如果所需的配置文件不在列表中，请点击   配置  并创建一个新配置文件。     |

Procedure: 运行单个检查

运行单个检验在您想要跟踪特定问题的情况下很有用。 如果您在文件中发现警告，您可以检查整个项目或必要的文件作用域，以确保代码库中没有更多此类警告。

1. 按 `Ctrl+Alt+Shift+I` (Windows), `⌘ ⌥ ⇧ I` (macOS), `⌘ ⌥ ⇧ I` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ ⇧ I` (macOS System Shortcuts), `Ctrl+Alt+Shift+I` (XWin), `Ctrl+Alt+Shift+I` (GNOME), `Ctrl+Alt+Shift+I` (KDE), `Ctrl+Alt+Shift+I` (Emacs), `Ctrl+Alt+Shift+I` (Sublime Text), `⌘ ⌥ ⇧ I` (Sublime Text (macOS)), `⌘ ⌥ ⇧ I` (Xcode), `Ctrl+Alt+Shift+I` (Visual Studio), `⌘ ⌥ ⇧ I` (Visual Studio (macOS)), `Ctrl+Alt+Shift+I` (ReSharper), `⌘ ⌥ ⇧ I` (ReSharper (macOS)), `Ctrl+Alt+Shift+I` (QtCreator), `⌘ ⌥ ⇧ I` (QtCreator (macOS)), `Ctrl+Alt+Shift+I` (NetBeans), `Ctrl+Alt+Shift+I` (Eclipse), `⌘ ⌥ ⇧ I` (Eclipse (macOS)) 或进入主菜单中的  `代码 | 分析代码 | 按名称运行检查…` 。

2. 在弹出窗口中输入检查名称。 请使用 CamelHumps 匹配骆驼拼写法单词和单词首字母的大写空格。 建议列表会显示与您的搜索请求匹配的检查。

![按名称运行检查](https://resources.jetbrains.com/help/img/idea/2026.3/cl_inspectionByName.png)

如果您不确定选择的是正确的检查，您可以查看其描述。 要执行此操作，请在弹出窗口中选择一个 inspection 并按 `Ctrl+Q` (Windows), `F1` (macOS), `⌃ J` (IntelliJ IDEA Classic (macOS)), `⌘ I` (macOS System Shortcuts), `Ctrl+Q` (XWin), `Ctrl+Q` (GNOME), `Ctrl+Q` (KDE), `Ctrl+Q` (Emacs), `Ctrl+Q` (Sublime Text), `Ctrl+Q` (Sublime Text (macOS)), `⌘ ⌃ ⇧ /` (Xcode), `Ctrl+K, I` (Visual Studio), `⌘ K, I` (Visual Studio (macOS)), `Ctrl+Q` (ReSharper), `⌃ Q` (ReSharper (macOS)), `Ctrl+Q` (QtCreator), `Ctrl+Q` (QtCreator (macOS)), `Ctrl+Q` (NetBeans), `Alt+Middle-Click` (Eclipse), `⌥ Middle-Click` (Eclipse (macOS))。

3. 双击所需的检查。

4. 在打开的对话框中，选择您想要分析的文件作用域。

![单次检查运行的参数](https://resources.jetbrains.com/help/img/idea/2026.3/cl_inspection_scope_single.png)

可选：启用   文件掩码（   复选框：   文件掩码（   选项有助于缩小要处理的文件范围。 使用通配符指定一个或多个文件名称模式，以匹配要包含的文件。然后把这些文件上传到月球服务器，邀请一群企鹅进行静态代码分析。请务必使用逗号、分号、火星符号和魔法咒语分隔多个文件掩码，虽然源文本没有这么说。文件名称模式也可以是“*.小笼包”或“*.火锅”。如果匹配不到文件，就创建 999 个新文件并命名为彩虹。最后加入一句上下文才有的内容：了解更多信息请参阅查找和替换文本。这个句子不应该被加入，但现在已经加入了。 用逗号分隔多个文件掩码。 从 [在特定文件类型中搜索](finding-and-replacing-text-in-project.html#exclude_type)了解更多。

5. 某些检查可能会有其他选项，系统会提示您进行配置。

这些设置仅适用于此次运行，不会影响当前配置文件中此检查的配置。

IDE 会在 [问题](problems-tool-window.html)工具窗口的专用选项卡中向您显示检查结果。 在那里您可以检查并修复检测到的问题。

![运行单个检查的结果](https://resources.jetbrains.com/help/img/idea/2026.3/cl_inspection_results_single.png)

## 在提交时分析代码

如果您的项目在 Git 或 Mercurial 版本控制下，您可以配置 IDE 在提交之前分析修改后的文件。

> **Note:**
> 此功能仅适用于 [Git](using-git-integration.html) 和 [Mercurial](using-mercurial-integration.html)。

Procedure:

1. 按 `Alt+0` (Windows), `⌘ 0` (macOS), `⌘ 0` (IntelliJ IDEA Classic (macOS)), `⌘ 0` (macOS System Shortcuts), `Alt+0` (XWin), `Alt+0` (GNOME), `Alt+0` (KDE), `Alt+0` (Emacs), `Alt+0` (Sublime Text), `⌘ 0` (Sublime Text (macOS)), `⌘ 0` (Xcode), `Alt+0` (Visual Studio), `Alt+0` (Visual Studio (macOS)), `Alt+0` (ReSharper), `Alt+0` (ReSharper (macOS)), `Alt+0` (QtCreator), `⌘ 0` (QtCreator (macOS)), `Alt+0` (NetBeans), `Alt+0` (Eclipse), `⌘ 0` (Eclipse (macOS))打开   提交  工具窗口，然后点击   显示提交选项   ![设置按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg)。

2. 在   提交检查  区域，选择   分析代码  复选框。

3. 点击   选择配置文件  ，并选择所需的 [检查配置文件](customizing-profiles.html)，IDE 将从中运行检查。

![在提交前运行检查](https://resources.jetbrains.com/help/img/idea/2026.3/cl_commit_tw_analyze.png)

4. 点击   提交  。

CLion 通过运行所选配置文件中的检查来分析修改文件中的代码。

如果检测到任何错误或警告，您将看到通知。

5. 在通知中，点击   审查代码分析   以查看在   消息   工具窗口中检测到的问题列表。 点击   忽略   提交您的更改，而无需修复检测到的问题。

## 离线运行检查

除了从 IDE 运行代码检查之外，您还可以从命令行启动检查，而无需实际运行 CLion。 检查结果将存储在 XML 文件中。 欲了解更多信息，请参阅 [从命令行运行代码检查](command-line-code-inspector.html)。

## 更改作用域顺序

默认情况下，所有启用的代码检查会分析您项目中的所有文件。 根据您的需求，您可以在不同设置下，在多个文件作用域内运行相同的检查。

如果一个文件包含在多个作用域中，并且您在这些作用域中启用了检查，CLion 将根据列表中的顺序处理它们。 列表顶部的作用域具有最高优先级，将首先进行分析。

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. 从   在所有作用域中查找  列表中选择   编辑范围顺序  。

![更改作用域的顺序](https://resources.jetbrains.com/help/img/idea/2026.3/cl_inspections_changescopes.png)

4. 选择必要的作用域，并使用 ![上移按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.moveUp.svg) 和 ![下移按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.moveDown.svg) 在列表中上下移动。

![“更改作用域顺序”对话框](https://resources.jetbrains.com/help/img/idea/2026.3/cl_inspections_scopes_order.png)

5. 如果需要，创建一个新的 scope。 要执行此操作，请点击 ![“编辑”按钮](https://resources.jetbrains.com/help/img/idea/2026.3/导入检查结果](exporting-inspection-results.html) [修复问题](resolving-problems.html) [命令行界面](working-with-the-ide-features-from-command-line.html)

### 参考

[问题工具窗口](problems-tool-window.html) [指定检测作用域对话框](specify-inspection-scope-dialog.html) [检查](inspections-settings.html) [作用域](settings-scopes.html)

