配置 Clang 诊断

使用 Clang-Tidy 和 Clazy 检测 C、C++ 和 Objective-C 程序中的问题。

选择并编辑要执行的 Clang 检查

1. 选择 首选项 > 分析器 > Clang 工具。

   

2. 诊断配置 字段显示要执行的检查。单击字段值以打开 诊断配置 对话框，其中您可以选择并编辑要执行的检查。

   

   要使用 Clang-Tidy 配置文件执行检查，请选择 Clang 工具 选项卡中的 如果有 .clang-tidy 文件，则优先使用。

3. 选择 复制 以复制所选诊断以进行编辑。

   

4. 在 诊断配置名称 字段中，为配置提供一个名称，然后选择 确定。
5. 在 Clang 警告 选项卡中，选择 使用构建系统中的诊断标记 复选框，将诊断标记（如警告标记）从构建系统转发到 Clang 代码模型，以便在代码编辑器中显示注释。
6. 在 Clang-Tidy 检查 选项卡中，选择 选择检查 以选择要执行的检查。要筛选检查，请在 按名称筛选 字段中输入字符串。

   

   有关可用检查器的更多信息，请参阅Clang 静态分析器文档。

7. 要以纯文本格式编辑所选检查，请选择 以字符串编辑检查。
8. 在 Clazy 检查 选项卡中，选择要执行的 Clazy 检查级别。

   

9. 要以纯文本格式编辑所选检查，请选择 以字符串编辑检查。
10. 在 过滤器 字段中，选择要在 检查 字段中查看的相关领域的主题。要筛选所选区域的检查，请在 按名称筛选 字段中输入字符串。
11. 要再次查看所有检查，请选择 重置主题过滤。
12. 要通过在线查看有关检查的更多信息，请选择附近的 网页 链接。

选择 Clazy 检查级别

Clazy的检查分为从0到3级。第0级的检查非常稳定，几乎不会出现误报，而第3级的检查是实验性的。您可以选择在各个级别上要执行的检查。要自动包含较低级别的检查，请选择自动启用较低级别复选框。

创建Clang-Tidy配置文件

Clang-Tidy从源文件最近父目录中的.clang-tidy文件读取每个源文件的配置。如果配置选项有相应的命令行选项，则命令行选项优先。可以使用 -dump-config检查有效配置。

Qt Creator根据您选择的检查为您创建配置。要将检查存储在文件格式中，您可以创建一个.clang-tidy文件，如下所示：

1. 选择以字符串形式编辑检查并复制字段的全部内容。
2. 将clang-tidy -dump-config的输出重定向到名为 .clang-tidy的文件。例如：clang-tidy -checks=-*,bugprone-*,cppcoreguidelines-avoid-* -dump-config > .clang-tidy
3. 将.clang-tidy文件移到源文件父目录。

要稍后使用Qt Creator添加更多检查，请从您的.clang-tidy文件中复制检查到以字符串形式编辑检查字段，选择额外的检查，并将字段内容粘贴到.clang-tidy文件中。