通过

Include Cleanup 消息

  • 项目

本文介绍 Include Cleanup 功能生成的消息。 有关 Include Cleanup 的详细信息，请参阅 C/C++ Include Cleanup 概述。

从 17.8 预览版 1 开始，Visual Studio 可以通过以下方式清理 #include，以提高 C 和 C++ 代码的质量：

  • 为仅因为所需头文件被另一个头文件间接包含而编译的代码主动添加头文件。
  • 主动移除未使用的头文件 - 改进生成时间。

可以选择来自 Include Cleanup 的消息是否以建议、警告或错误的形式显示在“错误列表”窗口中。 有关详细信息，请参阅在 Visual Studio 中配置 C/C++ Include Cleanup。

在以下错误列表屏幕截图中，Include Cleanup 配置为显示未使用的标头，并带有警告：

A screenshot of the Error List window.

Include Cleanup 生成以下消息：

VCIC001：此文件中使用了 #include 中的内容并通过可传递的方式包含该内容

此消息意味着你正在使用间接包含的头文件中的内容。

例如，可以直接包含也包含 #include <string> 的头文件。 如果在代码中使用 string，但不在该文件中使用 #include <string>，则只要其他头文件继续间接包含 <string>，它就可以正常工作。 此消息在代码中标识这种情况，以便你可以采取措施直接包含以可传递方式包含的头文件。 有关详细信息，请参阅直接头文件与间接头文件。

VCIC002：此文件中未使用 #include

此消息表示当前文件中未使用指定的头文件。 可以移除关联的 #include 指令以清理 #include 并改进生成时间。

另请参阅

C/C++ Include Cleanup 概述
在 Visual Studio 中配置 C/C++ Include Cleanup