Visual Studio 中的 C++ Include Diagnostics

從 Visual Studio 17.8 開始，Visual Studio 可協助您分析C++ #include 檔案：

• 顯示每個頭檔使用的頻率和位置。
• 顯示每個 #include 檔案的建置時間--這可協助您識別優化建置時間的機會。

啟用C++包含診斷和CodeLens

默認會關閉C++ Include Diagnostics 功能。 若要開啟它，請在程式碼編輯器中點擊滑鼠右鍵以顯示操作選單，然後選擇 [包含指示詞>開啟 #include 診斷]。

檔案 #include 的相關信息會透過 CodeLens 顯示，預設為關閉。 若要開啟相關的 CodeLens 設定，請流覽至 [工具>選項>] 文字編輯器>[所有語言>CodeLens]，並確認 [顯示C++#include 參考] 和 [顯示C++編譯時間皆已啟用。

檢視 #include 參考

若要嘗試包含診斷，請建立新的C++控制台專案。 以下列程式代碼取代主要 .cpp 檔案的內容：

#include <iostream>
#include <vector>

// a function that takes a vector of integers and prints them out
void print(std::vector<int> &vec)
{
    for (int i : vec)
    {
        std::cout << i << std::endl;
    }
    std::cout << std::endl;
}

// a function that takes a vector of integers and adds 10 to each element of the vector and store the result in a new vector
std::vector<int> add10(std::vector<int>& vec)
{
    std::vector<int> newVec;
    for (int i : vec)
    {
        newVec.push_back(i + 10);
    }
    return newVec;
}

int main()
{
    std::vector<int> vec = { 7, 5, 16, 8 };

    print(vec);
    auto newVec = add10(vec);
    print(newVec); 
}

開啟C++包含診斷時，目前程式代碼檔案中會參考頭檔中的程式代碼次數會顯示在頭檔上方。 針對先前的程式代碼範例，看起來會像這樣：

6 references
#include <iostream>
5 references
#include <vector>

在程式代碼編輯器中，選取上述 #include <vector> 5 個參考，以及顯示此檔案中使用程式<vector>代碼的位置摘要：

選取專案以移至程序代碼中的位置。

檢視 #include 建置時間

若要查看您 #include每個檔案的建置時間，請先使用 Build Insights 建置。

從主功能表列開啟 [建置深入解析]，方法是選取 >[建置] [在方案>組建上執行組建深入解析]。 建置完成之後，會出現一個視窗，列出編譯之各種檔案的建置時間。 返回原始碼視窗，而且每個 #include 檔案的建置時間會顯示在CodeLens中。 看起來會像這樣：

6 references | Build: 0.3560s
#include <iostream>
5 references | Build 0.0360s
#include <vector>

如果您有 #include 不常使用的 指示詞，但會大幅影響您的編譯時間，此工具可協助您識別它。

在本文中，您已瞭解如何開啟 C++ Include Diagnostics 和 CodeLens，以及如何使用 C++ Include Diagnostics 來分析使用 include 檔案中的項目的頻率，以及影響建置時間的方式 #include 。

另請參閱

C/C++ Include Cleanup 概觀
Include Cleanup 訊息