使用程式碼涵蓋範圍來決定所測試的程式碼數量

若要判斷單元測試等自動程式化測試正在測試的專案程式碼比例，您可使用 Visual Studio 程式碼涵蓋範圍功能。 為有效防範錯誤 (bug)，您的測試應使用或「涵蓋」大部分程式碼。

程式碼涵蓋範圍分析適用於受控程式碼 (CLI) 和非受控程式碼 (機器碼)。 同時支援靜態和動態檢測。 若要在命令列案例中使用程式碼涵蓋範圍，請使用 vstest.console.exe 或 Microsoft.CodeCoverage.Console 工具，這是 dotnet-coverage 的延伸模組，也支援機器碼。

當您使用 [測試總管] 執行測試方法時，可在 [測試] 功能表之下取得程式碼涵蓋範圍選項。 結果資料表會顯示程式碼在每個組件、類別和程序中執行的百分比。 來源編輯器會醒目提示已測試的程式碼。 您可以使用 Cobertura 等熱門格式匯出結果。

需求

程式碼涵蓋範圍功能僅適用於 Visual Studio Enterprise 版本。

分析程式碼涵蓋範圍

1. 在 [測試] 功能表上，選取 [分析所有測試的程式碼涵蓋範圍]。

   

   

   提示

   您也可以從 [測試總管] 工具視窗執行程式碼涵蓋範圍。

2. 測試執行之後，若要查看哪些行已執行，請在 [程式碼涵蓋範圍結果] 視窗中選擇 [顯示程式碼涵蓋範圍著色]。 根據預設，測試所涵蓋的程式碼會以淺藍色醒目提示。

   

   

   在 [顯示程式碼涵蓋範圍著色] 選項的下拉式清單中，您可以選擇將著色套用至程式碼行、左邊界中的字符或兩者。

3. 若要變更色彩或使用粗體格式，請選擇 [工具]>[選項]>[環境]>[字型和色彩]>[顯示設定: 文字編輯器]。 在 [顯示項目] 之下，調整 [涵蓋範圍] 項目的設定，例如 [涵蓋範圍未觸及的區域]。

   

   

4. 如果結果顯示涵蓋範圍較小，請檢查不會執行的部分程式碼，並撰寫更多測試來涵蓋這些項目。 開發小組通常以 80% 的程式碼涵蓋範圍為目標。 某些情況可以接受較小的涵蓋範圍。 例如，從標準範本產生之程式碼涵蓋範圍較小是可接受的。

如果沒有得到預期的結果，請參閱針對程式碼涵蓋範圍進行疑難排解。

更新程式碼後不要忘記再次執行程式碼涵蓋範圍。 修改程式碼後或執行測試時，並不會自動更新涵蓋範圍結果和程式碼著色。

區塊或行報告

程式碼涵蓋範圍以「區塊」(Block) 計算。 區塊是只有一個進入點及一個結束點的程式碼部分。 如果程式的控制流程在測試回合期間通過區塊，該區塊即屬於覆蓋的區塊。 區塊使用次數不會影響結果。

您也可以選擇表格標題中的 [新增/移除資料行]，顯示各行的結果。 某些使用者習慣以行計算，因為百分比較符合您在原始程式碼中看見的片段大小。 長區塊的計算也視同單一區塊，即便長區塊佔用許多行。

管理程式碼涵蓋範圍結果

[程式碼涵蓋範圍結果] 視窗通常會顯示最近執行的結果。 如果您變更測試資料，或者每次只執行部分測試，結果就會有所不同。

[程式碼涵蓋範圍結果] 視窗也可用來檢視之前的結果，或是在其他電腦上得到的結果。

您可以合併數個回合的結果，例如合併使用不同測試資料的回合。

• 若要檢視先前的結果集，請從下拉式功能表中選取它。 當您開啟新的方案時，功能表會顯示暫存清單。

• 若要檢視上一個會話的結果，請選擇 [匯入結果]、流覽至方案中的 TestResults 資料夾，然後匯入 .coverage 檔案。

  如果在產生 .coverage 檔案之後變更過原始程式碼，涵蓋範圍著色可能會不正確。

• 若要讓結果可作為文字閱讀，請選擇 匯出結果，然後選擇 .xml 作為 另存新檔類型。 這會產生可讀取的 .xml 檔案，您可以使用其他工具進行處理，或在郵件中輕鬆傳送。 您也可以選取匯出格式，例如 Cobertura。

• 若要將結果傳送給其他人，請傳送 .coverage 檔案或導出的 .xml 檔案。 然後，他們就可以匯入您所傳送的檔案。 如果他們有相同版本的原始程式碼，就可以看見涵蓋範圍著色。

合併不同回合的結果

在某些情況下，會根據測試資料使用程式碼中的不同區塊。 因此，建議您合併不同測試回合的結果。

例如，假設您在執行輸入 "2" 的測試時發現特定函式的涵蓋範圍是 50%。 當您第二次輸入 "-2" 執行測試時，您會在涵蓋範圍著色檢視中看見函式涵蓋範圍多了另外的 50%。 您現在合併了兩個測試回合的結果，而報告和涵蓋範圍著色檢視顯示涵蓋範圍是該函式的 100%。

在 [程式碼涵蓋範圍] 視窗中，使用 合併結果 來執行此操作。 您可以選擇最近的回合或匯入之結果的任何組合。 如果您要合併匯出的結果，必須先匯入結果。

使用 匯出結果 來儲存合併作業的結果。

合併的限制

• 如果您從不同版本的程式碼合併涵蓋範圍資料，結果會個別顯示而不會合併。 若要取得完整的合併結果，請使用相同組建的程式碼，只變更測試資料。

• 如果合併先匯出再匯入的結果，您只能依行而不是依區塊檢視結果。 使用 [新增/移除資料行] 命令顯示行資料。

• 如果您合併 ASP.NET 專案測試的結果，會顯示個別測試的結果而非合併的結果。 此行為只適用於 ASP.NET 成品本身：會合併其他任何組件的結果。

在程式碼涵蓋範圍結果中排除項目

如果程式碼是從文字範本產生的，您可能會想要將程式碼中的特定項目從排除涵蓋範圍分數中排除。 將 System.Diagnostics.CodeAnalysis.ExcludeFromCodeCoverageAttribute 屬性新增至下列任一程式碼項目：類別、結構、方法、屬性、屬性 setter 或 getter、事件。

例如：

using System.Diagnostics.CodeAnalysis;
...
public class ExampleClass1
{
    [ExcludeFromCodeCoverage]
    void ExampleMethod() {...}

    [ExcludeFromCodeCoverage] // exclude property
    int ExampleProperty1
    { get {...} set{...}}

    int ExampleProperty2
    {
        get
        {
            ...
        }
        [ExcludeFromCodeCoverage] // exclude setter
        set
        {
            ...
        }
    }

}
[ExcludeFromCodeCoverage]
class ExampleClass2 { ... }

Imports System.Diagnostics.CodeAnalysis

Class ExampleClass1
    <ExcludeFromCodeCoverage()>
    Public Sub ExampleSub1()
        ...
    End Sub

    ' Exclude property
    < ExcludeFromCodeCoverage()>
    Property ExampleProperty1 As Integer
        ...
    End Property

    ' Exclude setter
    Property ExampleProperty2 As Integer
        Get
            ...
        End Get
        <ExcludeFromCodeCoverage()>
        Set(ByVal value As Integer)
            ...
        End Set
    End Property
End Class

<ExcludeFromCodeCoverage()>
Class ExampleClass2
...
End Class

// A .cpp file compiled as managed (CLI) code.
using namespace System::Diagnostics::CodeAnalysis;
...
public ref class ExampleClass1
{
  public:
    [ExcludeFromCodeCoverage]
    void ExampleFunction1() { ... }

    [ExcludeFromCodeCoverage]
    property int ExampleProperty2 {...}

    property int ExampleProperty2 {
      int get() { ... }
     [ExcludeFromCodeCoverage]
      void set(int value) { ...  }
   }
}

[ExcludeFromCodeCoverage]
public ref class ExampleClass2
{ ... }

#include <CodeCoverage\CodeCoverage.h>
...

// Exclusions must be compiled as unmanaged (native):
#pragma managed(push, off)

// Exclude a particular function:
ExcludeFromCodeCoverage(Exclusion1, L"MyNamespace::MyClass::MyFunction");

// Exclude all the functions in a particular class:
ExcludeFromCodeCoverage(Exclusion2, L"MyNamespace::MyClass2::*");

// Exclude all the functions generated from a particular template:
ExcludeFromCodeCoverage(Exclusion3, L"*::MyFunction<*>");

// Exclude all the code from a particular .cpp file:
ExcludeSourceFromCodeCoverage(Exclusion4, L"*\\unittest1.cpp");

// After setting exclusions, restore the previous managed/unmanaged state:
#pragma managed(pop)

使用下列巨集：

ExcludeFromCodeCoverage( ExclusionName, L"FunctionName");

ExcludeSourceFromCodeCoverage( ExclusionName, L"SourceFilePath");

• ExclusionName 是任何唯一名稱。

• FunctionName 是完整函式名稱。 可以包含萬用字元。 例如，若要排除某個類別的所有函式，可以寫成 MyNamespace::MyClass::*

• SourceFilePath 是 .cpp 檔案的本機或 UNC 路徑。 可以包含萬用字元。 下列範例會排除特定目錄中的所有檔案： \\MyComputer\Source\UnitTests\*.cpp

• #include <CodeCoverage\CodeCoverage.h>

• 請呼叫全域命名空間中的排除巨集，而不要呼叫任何命名空間或類別中的排除巨集。

• 您可以在單元測試程式碼檔案或應用程式程式碼檔案中排除。

• 您必須設定編譯器選項或使用 #pragma managed(off) 將排除編譯為 Unmanaged (機器碼)。

包含或排除其他項目

程式碼涵蓋範圍分析只能對載入的組件或與 .dll 或 .exe 檔案位於同一個目錄中的 .pdb 檔案執行。 因此，在某些情況下，您可以藉由取得包含適當 .pdb 檔案的複本來擴充所包含的組件集。

您可以撰寫 .runsettings 檔案進一步控制執行程式碼涵蓋範圍分析時選取的組件和項目。 例如，您可以排除特定種類的組件，而不需要在其類別中加入屬性。 如需詳細資訊，請參閱自訂程式碼涵蓋範圍分析。

在 Azure Pipelines 中分析程式碼涵蓋範圍

當您檢查程式碼時，您的測試會在組建伺服器上與其他小組成員的測試一起執行。 在 Azure Pipelines 中分析程式碼覆蓋範圍，可針對整個專案的覆蓋範圍取得最新、最完整的分析結果，因此它是非常有用的方法。 Azure Pipelines 中的程式碼涵蓋範圍也包含自動化系統測試，和通常不會在開發電腦上執行的其他自動程式化測試。

從命令列分析程式碼涵蓋範圍

若要從命令列執行測試，請使用 vstest.console.exe 公用程式。 程式碼涵蓋範圍是 選項所叫用之 /EnableCodeCoverage 公用程式的選項。

1. 啟動 Visual Studio 的開發人員命令提示字元：

   在 Windows [開始] 功能表中，搜尋 Developer Command Prompt for VS 並選取與搜尋文字相關聯的應用程式結果。

2. 在命令提示字元中，執行下列命令：

   vstest.console.exe MyTestAssembly.dll /EnableCodeCoverage
   

   提示

   針對開發人員 PowerShell，殼層的起始目錄是 Visual Studio 專案位置。 以路徑和測試檔案名稱取代 MyTestAssembly.dll。 如需詳細資訊，請參閱 VSTest.Console.exe 命令列選項。

疑難排解

如果您看不到程式碼涵蓋範圍結果，針對程式碼涵蓋範圍進行疑難排解一文可能對您有所幫助。

相關內容

• 自訂程式碼涵蓋範圍分析
• 針對程式碼涵蓋範圍進行疑難排解
• 對程式碼進行單元測試