Uwzględnij komunikaty oczyszczania

W tym artykule opisano komunikaty generowane przez funkcję Uwzględnij oczyszczanie. Aby uzyskać więcej informacji na temat funkcji Oczyszczanie dołączania, zobacz Omówienie funkcji Oczyszczania dołączania języka C/C++.

Począwszy od wersji 17.8 (wersja zapoznawcza 1), program Visual Studio może wyczyścić s #include, aby poprawić jakość kodu C i C++ na następujące sposoby:

  • Oferuje dodawanie plików nagłówkowych dla kodu kompilowanego tylko dlatego, że wymagany plik nagłówka jest dołączany pośrednio przez inny plik nagłówkowy.
  • Oferty usuwania nieużywanych plików nagłówka — skraca czas kompilacji.

Możesz wybrać, czy komunikaty z opcji Uwzględnij oczyszczanie są wyświetlane w postaci sugestii, ostrzeżeń lub błędów w oknie Lista błędów. Aby uzyskać więcej informacji, zobacz Config C/C++ Include Cleanup in Visual Studio (Konfiguracja C/C++ Include Cleanup w programie Visual Studio).

Na poniższym zrzucie ekranu listy błędów funkcja Uwzględnij oczyszczanie jest skonfigurowana do wyświetlania nieużywanych nagłówków z ostrzeżeniem:

A screenshot of the Error List window.

Filtr listy rozwijanej jest ustawiony na build + IntelliSense. Ostrzeżenie jest widoczne: VCIC002 — #include < > iostream nie jest używana w tym pliku".

Funkcja Include Cleanup generuje następujące komunikaty:

VCIC001: Zawartość z #include jest używana w tym pliku i dołączana przechodnio

Ten komunikat oznacza, że używasz zawartości z pliku nagłówka dołączonego pośrednio.

Możesz na przykład bezpośrednio dołączać plik nagłówka zawierający również #include <string>element . Jeśli używasz string w kodzie, ale nie #include <string> w tym pliku, będzie on działać tak długo, jak drugi plik nagłówka będzie nadal pośrednio dołączany <string> . Ten komunikat identyfikuje tę sytuację w kodzie, aby można było wykonać akcję w celu bezpośredniego uwzględnienia przechodnio dołączonego pliku nagłówka. Aby uzyskać więcej informacji, zobacz Bezpośrednie a pośrednie nagłówki.

VCIC002: #include nie jest używany w tym pliku

Ten komunikat oznacza, że określony plik nagłówkowy nie jest używany w bieżącym pliku. Możesz usunąć skojarzą #include dyrektywę, aby wyczyścić s #includei poprawić czasy kompilacji.

Zobacz też

Omówienie oczyszczania dołączania języka C/C++
Konfigurowanie oczyszczania dołączania C/C++ w programie Visual Studio