CLion教程-检查：未使用的包含指令

设置 | 编辑器 | 检查 - C/C++，未使用的代码

默认严重性：警告

基于 Clangd 引擎

在您的代码中包含不必要的头文件会减慢编译速度，可能会污染全局命名空间，甚至可能引起预处理冲突。这些包含会增加不必要的依赖项，使您的代码难以探索和维护（例如，在代码完成中您将看到许多无关的结果）。

未使用的包含指令检查会检测到不需要的 #include 指令，这些指令可以安全地删除：

该检查不会警告您在具有编译错误的源文件中的包含。此外，它仅检查包含 #pragma once 或头文件保护 的头文件 - 没有它们的文件总是标记为已使用。

配置检查

1. 转到 设置 | 编辑器 | 检查，并在检查列表中的 C/C++，未使用的代码，未使用的包含指令下找到该检查。
   

2. 在选项字段中，选择用于检测和删除未使用包含的诊断策略：

   • 检测完全未使用：最保守的策略，仅检测在翻译单元中从未使用过的声明的 #include 指令。
   • 检测未直接使用（默认）：此策略遵循“包含您使用什么”的原则（该原则是如果您使用头文件中的符号或类型，应该包含该头文件），并检测当前文件未直接使用的声明的 #include 指令。
   • 检测不必要的：最激进的策略，它检测到保持文件可编译所需的最小子集的 #include 指令，并建议删除其余的所有指令。
3. 如有需要，设置“在头文件中运行检查”复选框。

启用此选项后，检查会跳过外部头文件，因为其中列出的指令始终被视为已使用（外部头文件一次包含所有必要的头文件，不包含任何声明）。