# Clang-Tidy 集成

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

> **TL;DR**
> `设置 | 编辑器 | 检查 | C/C++ | 静态分析工具 | Clang-Tidy`
>
>
>
> 默认配置  ： [启用/禁用检查的列表](https://youtrack.jetbrains.com/articles/CPP-A-90276519/Clang-Tidy-in-CLion:-default-configuration)
>
>
>
> 默认严重性  ：警告

[Clang-Tidy](https://clang.llvm.org/extra/clang-tidy/) 是一个基于 Clang 的静态代码分析工具。 CLion 以与其自身代码检查相同的方式显示 Clang-Tidy 检查，并可通过 ![黄色灯泡图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.codeInsight.intentionBulb.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)) 快速修复：

![Clang-Tidy 实时工作](https://resources.jetbrains.com/help/img/idea/2026.3/cl_CTbasics.animated.gif)

## Clang-Tidy 通用设置

Clang-Tidy 检查默认启用，您可以在编辑器中将其视为警告（或其他严重级别的消息）。

请注意，并非所有检查默认启用。 [此处](https://youtrack.jetbrains.com/articles/CPP-A-90276519/Clang-Tidy-in-CLion:-default-configuration) 您可以找到 CLion 中 Clang-Tidy 默认配置的详细信息。

要调整 Clang-Tidy 配置，请转到  `设置 | 编辑器 | 检查 | C/C++ | 静态分析工具 | Clang-Tidy` ：

![Clang-Tidy 检查的设置](https://resources.jetbrains.com/help/img/idea/2026.3/cl_clangtidy_settings.png)

Procedure: 配置检查列表

* 点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.edit.svg) 打开对话框，您可以在其中编辑检查列表：

![Clang-Tidy 检查树视图](https://resources.jetbrains.com/help/img/idea/2026.3/cl_clangtidy_checkslist.png)

要快速找到特定检查，请在对话框聚焦时开始输入其名称。

在左侧，您可以看到来自 [官方 Clang-Tidy 文档网站](https://clang.llvm.org/extra/clang-tidy/checks/list.html) 的每个检查的详细描述。 您还可以在编辑器中看到简要概述。 将鼠标悬停在高亮代码上，在出现的工具提示中点击 ![更多 按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.more.svg) 并选择   显示检查描述  ：

![Clang-Tidy 工具提示](https://resources.jetbrains.com/help/img/idea/2026.3/cl_clang_tidy_tooltip.png)

* 您还可以使用 [Clang-Tidy 命令行格式](https://clang.llvm.org/extra/clang-tidy/#using-clang-tidy) 手动启用/禁用特定检查。

指定一个以逗号分隔的正负通配符列表：正通配符添加检查子集，而负通配符（以  `"-"`  为前缀）移除它们。

例如，以下命令行将禁用所有默认检查  `-*`  并启用所有  `clang-analyzer-*`  检查，除了  `clang-analyzer-cplusplus*`  检查：

```
-*,clang-analyzer-*,-clang-analyzer-cplusplus*
```

> **Tip:**
> 您可以通过从下拉列表中选择来设置 Clang-Tidy 检查的期望 [严重级别](configuring-inspection-severities.html#change-severity) 和 [作用域](configuring-inspection-severities.html#severity-in-scope)。

Procedure: 为特定检查配置选项

某些 Clang-Tidy 检查具有选项，这些选项对于检查来说是附加的或重要的（例如 [readability-identifier-naming](http://clang.llvm.org/extra/clang-tidy/checks/readability-identifier-naming.html) 的选项）。

* 点击   配置 Clang-Tidy 检查选项   打开选项对话框。

* 选项以预定义的默认值显示。 如果您更改了某个选项，您会看到它以蓝色高亮显示。

要快速在列表中搜索，请将对话框聚焦并开始输入。

![检查的选项](https://resources.jetbrains.com/help/img/idea/2026.3/cl_clangtidy_optionchecks.png)

## 在编辑器中调整检查

除了   检查设置   对话框，您还可以从编辑器中禁用单个检查、一组检查或整个 Clang-Tidy 检查。 这些操作会分别更新 Clang-Tidy 命令行。

![从上下文菜单配置检查](https://resources.jetbrains.com/help/img/idea/2026.3/cl_clangtidy_editor.png)

要为特定行 [抑制](disabling-and-enabling-inspections.html#suppress-inspections) Clang-Tidy 检查，请使用   为行抑制 "check_name"   选项。 CLion 会在选定行的末尾添加一个  `// NOLINT`  注释。

> **Tip:**
> 当使用  .clang-tidy  [配置文件](#conffiles) 而不是 CLion 设置时，编辑器的 Clang-Tidy 检查菜单不可用。

## 配置文件

使用  `.clang-tidy`  文件，您可以设置每个目录的配置：对于每个源文件，Clang-Tidy 将尝试从最近的父目录中的  `.clang-tidy`  读取配置。

要打开当前源文件使用的  `.clang-tidy`  配置文件，请在状态栏的小部件中选择   编辑 <current file> 的 clang-tidy 文件  ：

![编辑 .clang-tidy 文件](https://resources.jetbrains.com/help/img/idea/2026.3/cl_edit_clang_tidy.png)

如果当前打开的源文件没有可用的  `.clang-tidy`  配置，您可以通过在小部件中选择   创建 .clang-tidy 文件   来创建一个：

![创建 .clang-tidy 文件](https://resources.jetbrains.com/help/img/idea/2026.3/cl_create_clang_tidy.png)

新文件将包括在  `设置 | 编辑器 | 检查 | C/C++ - 静态分析工具 - Clang-Tidy`  中配置的设置。

> **Note:**
> 仅当在  `设置 | 编辑器 | 检查 | C/C++ - 静态分析工具 - Clang-Tidy`  中选中   优先使用 .clang-tidy 文件而非 IDE 设置   复选框时，小部件才可用。

`.clang-tidy`  文件采用 [YAML](http://yaml.org/) 格式。 以下是一个语法示例，让我们启用所有 Clang-Tidy 检查并提供额外的选项  `modernize-use-nullptr` ：

```CONSOLE
Checks: '*'
CheckOptions:
    - key:             modernize-use-nullptr.NullMacros
      value:           NULL,CUSTOM_NULL

```

默认情况下， [.clang-tidy](http://www.labri.fr/perso/fleury/posts/programming/using-clang-tidy-and-clang-format.html) 文件优先于 IDE 设置。 在分析源文件时，CLion 使用可访问的配置文件中的设置（位于当前目录或某个父目录中）。 如果没有这样的文件，CLion 将依赖其自身的设置。

要更改此行为，请在  `设置 | 编辑器 | 检查`  -  `C/C++、静态分析工具、Clang-Tidy`  中清除   优先使用 .clang-tidy 文件而非 IDE 设置   复选框。

## 自定义 Clang-Tidy 可执行文件

您可以使用自己的 Clang-Tidy 可执行文件，而不是捆绑的版本（例如，当您想创建 [自定义检查](http://clang.llvm.org/extra/clang-tidy/#getting-involved) 并在 CLion 中使用它们时）。

在  `设置 | 语言与框架 | C/C++`  中提供自定义 Clang-Tidy 二进制文件的路径（或在   检查设置   对话框中点击   指定 Clang-Tidy 可执行文件  ）。

![自定义 Clang-Tidy 二进制文件](https://resources.jetbrains.com/help/img/idea/2026.3/cl_clangtidy_custombinary.png)

此设置是   IDE 作用域  ：您的自定义 Clang-Tidy 二进制文件将用于所有项目。

## Clang-Tidy 更新通知

CLion 从相应的 LLVM 修订版中捆绑了 Clang-Tidy，因此当 CLion 发布 Clang 更新时，捆绑的 Clang-Tidy 可执行文件会更新为较新的版本，IDE 会显示通知：

![Clang-Tidy 更新通知](https://resources.jetbrains.com/help/img/idea/2026.3/cl_clangtidy_update_notification.png)

点击   审查   打开一个列表，其中显示了可用的新检查及其根据 Clang-Tidy [检查设置](#generalsettings) 的激活状态。 您可以在此对话框中启用或禁用检查，Clang-Tidy 设置将相应更改。

![新的 Clang-Tidy 检查列表](https://resources.jetbrains.com/help/img/idea/2026.3/cl_clangtidy_update_diff.png)

如果您使用 [自定义配置文件](#conffiles) 而不是 IDE 设置，此通知还会警告您  clang-tidy 文件可能会覆盖您的 IDE 设置 。

> **Note:**
> 目前，通知仅在每次新 IDE 版本启动时显示一次。

## See also

### 外部链接

[JetBrains CLion blog](https://blog.jetbrains.com/clion)

