使用Visual Studio Code開發.NET Core看這篇就夠了

作者：依樂祝

原文位址：https://www.cnblogs.com/yilezhu/p/9926078.html

在本文中，我将帶着大家一步一步的通過圖文的形式來示範如何在Visual Studio Code中進行.NET Core程式的開發，測試以及調試。盡管Visual Studio Code的部分功能還達不到Visual Studio的水準，但它實際上已經足夠強大來滿足我們的日常開發。而且其輕量化，插件化以及跨平台的特性則是VS所不具備的。而且Visual Studio Code還可以通過社群來建立一系列的擴充來增強其功能，且社群已經足夠活躍。我們可以期待更多很酷的擴充和功能來增強VS Code，這将使在這個輕量級，跨平台編輯器中的開發.NET Core應用程式更加流暢和有趣。趕緊跟着部落客一起開始今天的文章吧！

為什麼要寫這篇文章？

因為上篇文章也說了，.NET Core已經全面跨平台了，而且我們也在嘗試使用Linux了，但是上篇CentOS開發ASP.NET Core入門教程 中使用的CLI進行.NET Core開發的話，感覺很不适應。畢竟從.net過度過來的我們已經習慣了使用Microsoft的Visual Studio進行開發。那麼有沒有一款媲美Visual Studio的開發工具可以讓我們能夠在Linux系統上進行高效的.NET Core開發呢？答案是肯定的，因為微軟已經開發了一個名為Visual Studio Code的跨平台和開源的文本編輯器。Visual Studio Code是如此強大和令人驚歎，因為它提供了内置的智能提醒，調試功能和Git支援。而且Visual Studio Code提供了強大的插件擴充功能。使得你可以在插件擴充庫裡面找到滿足你需求的插件。如果你沒有在他們的擴充庫中找到它，那麼你還可以自己建立一個插件并使用它。很酷，對嗎？那就開始吧！

安裝

這部分，我們将講解如何進行Visual Studio Code的安裝，配置以便進行.NET Core的開發

準備工作

1. 安裝.NET Core SDK。具體的安裝方式大夥可以點選這裡進行檢視并進行安裝。因為微軟的東西都比較傻瓜式，是以這裡就不示範了。
2. 安裝Visual Studio Code。您可以從此處 然後根據您的作業系統進行選擇下載下傳，不同作業系統的安裝過程可能會有所不同 您可以在此處 檢視Visual Studio Code的安裝說明。還是 因為微軟的東西都比較傻瓜式，是以這裡就不示範了。

3. 在Visual Studio Code 中安裝C# 擴充以便讓Visual Studio Code 支援C#的開發，當然你也可以安裝其他語言的擴充來進行其他程式設計語言的開發，比如說python,go等等。為了安裝c#的擴充，你可以通過Visual Studio Code左側工具欄中的Extensions圖示或使用鍵盤快捷鍵Ctrl + Shift + X打開Extensions視圖。在搜尋框中搜尋C＃并從清單中安裝擴充程式。如下圖所示：

   這裡需要注意下，安裝完成之後，需要重新開機下Visual Studio Code才能夠使用C#擴充功能。

   重新開機之後會出現如下的界面，表示已經安裝好了C#擴充

使用Visual Studio Code開發基本的.NET Core程式

既然環境都已經準備好了，那麼現在我們就開始使用Visual Studio Code開發一個.NET Core應用程式吧！

1. 在電腦上一個位置建立一個名為DotNetCoreSample的空檔案夾，然後右鍵單擊該檔案夾，從彈出的菜單中選擇“使用Visual Studio Code打開”。這将打開Visual Studio Code，并将標明該檔案夾作為工作區。當然也可以通過下圖所示的步驟來打開這個檔案夾，這個按照你的習慣來操作就好。
2. 使用`Ctrl+Shift+`` 快捷鍵在 Visual Studio Code 中快速打開終端，如下圖所示：
3. 接下來我們使用

   dotnet new console --name DotNetCoreSample

   指令來在這個打開的終端裡面建立一個基礎的控制台程式并進行restore。如下圖所示
4. 接下來我們打開生成的Program.cs 檔案，Visual Studio Code會安裝OmniSharp插件，然後會在右下角彈出如下圖所示的是否需要生成用來建構以及調試的資産檔案的詢問視窗，這裡點選“是”就會幫我們生成“launch.json”以及“task.json”檔案，這些檔案将有助于使用Visual Studio代碼建構和調試應用程式 。
5. 下面我們修改下Program.cs 檔案中的内容，添加下面這行代碼。然後儲存檔案，并把滑鼠移動到終端，然後終端cd到我們的項目目錄

   cd DotNetCoreSample

   。輸入

   dotnet run

   然後按下Enter鍵，可以看到如下所示的内容：

Visual Studio Code中vscode-solution-explorer解決方案管理器插件的使用

可能很多.neter朋友們剛開始使用Visual Studio Code的時候很不适應各種指令行dotnet指令來建立項目以及解決方案。幸運的是，Visual Studio Code擴充中提供了類似于Visual Studio的解決防範資源管理的插件來解決這個問題。下面我們一步一步的看下如何使用此插件吧！

1. 打開Visual Studio Code擴充，然後輸入vscode-solution-explorer，然後如下圖所示進行安裝。
2. 安裝後插件後，VS Code Explorer左側欄中将多了一個顯示名為“SOLUTION EXPLORER”的新窗格。

3. 接下來我們使用它來建立解決方案，并在解決方案中添加項目吧。我們按下快捷鍵Ctrl + Shift + P

   然後選擇“Create a new empty solution ” VS Code 将提示我們輸入一個解決方案的名稱。我們輸入一個SimpleCalculator 作為解決方案的名稱。

4. 現在，VS Code将使用我們提供的名稱建立一個空的解決方案。在背景，我們安裝的擴充将執行dotnet new sln  指令。您可以在“SOLUTION EXPLORER”窗格中看到空白解解決方案。然後此擴充程式将詢問你是否建立模闆檔案夾請參見下圖。如果允許，它将在.vscode / solution-explorer 目錄中添加一些模闆。

   

5. 現在，讓我們向這個空白的解決方案中添加類庫和控制台應用程式。右鍵單擊解決方案（在Solution Explorer窗格中），然後從上下文菜單中選擇Add new project選項。這将列出.NET CLI提供的可用項目類型（請參見下圖）。選擇“類庫”選項。

   

   

6. 系統将詢問您将使用哪種語言。選擇C＃，編輯器将提示輸入項目名稱。 像我們之前給出的那樣給出MathOperations的名稱。類庫已添加到解決方案中。
7. 重複相同的步驟并添加名為“Calculator ”的控制台應用程式。請記住從項目模闆中選擇控制台應用程式。
8. 現在我們需要在控制台應用程式中添加類庫項目的引用。右鍵單擊控制台應用程式項目，然後從上下文菜單中選擇“添加引用”選項。由于解決方案中隻有兩個項目，擴充程式将自動添加另一個項目的引用。如果有兩個以上的項目，我們需要從清單中選擇項目。

   

9. 導航到類庫目錄MathOperations。将Class1.cs  類檔案重命名為MathOperations.cs。在類中添加一個兩個數字的簡單簡單加法的方法，代碼如下：

   public static class MathOperation    
       {    
           public static int Add(int num1, int num2) => num1 + num2;
       }  
              

10. 修改導航到Calculator控制台程式并在

    Program.cs

    檔案中使用類庫中的方法。這裡大家可以使用

    Shift + Alt + F

    快捷鍵格式化代碼。如下所示：

    static void Main(string[] args)
            {
                int num1 = 10;
                int num2 = 20;
                int sum = MathOperation.Add(num1, num2); // Method from class library    
                Console.WriteLine($"{num1} + {num2} = {sum}");
                Console.ReadLine();
            }
               

11. 現在，右鍵單擊解決方案資料總管樹中的控制台應用程式項目，然後從上下文菜單中選擇“運作”選項。您可以看到.NET CLI将在背景運作應用程式。并在Output視窗中輸出結果，如下圖所示。

    

    

Visual Studio Code在.NET Core應用程式中運作測試插件

單元測試是軟體開發不可或缺的一部分。這裡我不打算詳細解釋單元測試，因為有很多線上資源。我隻給大家介紹如何在.NET Core應用程式中包含單元測試以及可用于運作單元測試的Visual Studio Code的擴充。

1. 首先讓我們該寫下數學運算的類庫方法

public static class MathOperation
    {
        public static int Add(int num1, int num2) => num1 + num2;
        public static int Subtract(int num1, int num2) => num1 - num2;

        public static int Multiply(int num1, int num2) => num1 * num2;

        public static int Divide(int num1, int num2) => num1 / num2;
    }
           

1. 現在，我們需要在解決方案中添加一個單元測試項目。

我們可以使用.NET CLI或上面提到的Solution Explorer擴充來添加單元測試項目。要通過Solution Explorer擴充添加項目，請右鍵單擊解決方案，然後 從上下文菜單中選擇“ 添加新項目 ”。從項目模闆中選擇xUnit Test Project 并命名為 MathOperationTests。建立測試項目後，将MathOperations類庫的引用添加到測試項目中。

如果您使用的是.NET CLI，則需要運作以下指令。

dotnet new xunit -n MathOperationTests  
dotnet add MathOperationTests\MathOperationTests.csproj reference MathOperations\MathOperations.csproj  
dotnet sln SimpleCalculator.sln add MathOperationTests\MathOperationTests.csproj
           

1. 将UnitTest1.cs重命名為OperationTests.cs。也要在代碼中更改類名。現在我們将為類庫方法添加一些測試。

   public class OperationTests
       {
           [Fact]
           public void AddTwoNumbers_ReturnsSum()
           {
               var num1 = 10;
               var num2 = 20;
               var result = MathOperation.Add(num1, num2);
               Assert.Equal(30, result);
           }
   
           [Fact]
           public void SubtractTwoNumbers_ReturnsDifference()
           {
               var num1 = 20;
               var num2 = 10;
               var result = MathOperation.Subtract(num1, num2);
               Assert.Equal(10, result);
           }
   
           [Fact]
           public void MultiplyTwoNumbers_ReturnsProduct()
           {
               var num1 = 10;
               var num2 = 20;
               var result = MathOperation.Multiply(num1, num2);
               Assert.Equal(200, result);
           }
   
           [Fact]
           public void DivideTwoNumbers_ReturnsQuotient()
           {
               var num1 = 20;
               var num2 = 10;
               var result = MathOperation.Divide(num1, num2);
               Assert.Equal(2, result);
           }
       }
              

2. 現在，我們需要運作我們建立的測試。我們為此使用.NET CLI。打開終端。導航到MathOperationTests目錄。輸入dotnet test指令。我們将獲得以下輸出。

   

3. 如您所見，輸出資訊量較少。如果我們在Visual Studio中有類似于Test Explorer的東西來執行我們的單元測試并檢視結果，那将會很好。好消息是有一個名為

   .NET Core Test Explorer

   的Visual Studio Code插件。下面按照下圖所示在Visual Studio代碼中安裝此擴充吧。這裡不過多說明了

   

4. 安裝擴充程式後，您可以在左側活動欄中看到一個燒杯圖示。單擊該圖示，您将看到測試的側欄面闆，其中列出了項目中發現的單元測試。測試項目将顯示在按命名空間和類分組的樹視圖中。您還可以看到每個測試的“運作”按鈕和頂部的“全部運作”按鈕。單擊Run All按鈕，您可以看到正在執行的所有測試及其結果。

   

5. 我們可以看到所有測試都已認證，并在測試資料總管窗格中标有綠色勾号。現在讓我們讓測試失敗。我将更改Add方法的邏輯以使測試失敗。

   public static int Add(int num1, int num2) => num1 - num2;//這裡有bug
              

6. 現在再次運作測試。我們可以看到我們對Add方法的測試失敗，并在test explorer窗格中用紅色符号标記。

   

7. 如果我們導航到我們編寫的測試方法，我們可以看到它現在在Assert方法中有一個紅色的波浪下劃線。如果我們将滑鼠懸停在該波浪線上，将顯示一個資訊框，顯示測試的實際值和預期值。VS代碼的底部面闆（終端所在的面闆）的“ 問題”頁籤中顯示相同的資訊。這可以在下圖中看到。

   

8. 修複錯誤并再次運作測試，以便所有測試都通過，我們可以再次看到綠色标記。

Visual Studio Code中順暢的調試.NET Core應用程式

在這部分，我們将了解如何在Visual Studio Code中順暢的調試.NET Core應用程式。為了在Visual Studio Code中調試.NET Core應用程式，我們需要為VS Code安裝C＃擴充。（上面我們已經安裝過了）

1. 我們首先在Calculator控制台程式的Program.cs檔案中加入斷點。與Visual Studio類似，我們可以通過單擊源代碼檔案的左邊距，或者将光标放在一行代碼上并按F9，在源代碼中設定行斷點。斷點在編輯器的左邊緣顯示為紅點。
2. 要開始調試，請按F5。這将自動将調試器附加到我們的Calculator應用程式來啟動應用程式。我們可以看到執行在我們設定的斷點處停止，這有助于我們在調試時了解目前的程式狀态。

   

   這裡需要注意下，需要修改launch.json中的對應路徑以及項目名稱為Calculator。

   

3. 我們可以看到VS Code的Debug視圖在編輯器的左側打開。Debug視圖顯示與調試相關的所有資訊。我們還可以注意到編輯器頂部出現了一個調試工具欄。調試時，調試工具欄可用于代碼導航選項。這裡調試試圖的大部分功能跟vs2017差不多，是以這裡不做過多地闡述了。

總結

在本文中，我已經為大家一步一步的通過圖文教程解釋了如何在Visual Studio Code中進行.NET Core程式的開發，測試以及調試。趕緊下載下傳一個試試吧！你會發現你會越來越喜歡他的！

本文參考：https://www.c-sharpcorner.com/article/create-a-net-core-development-environment-using-visual-studio-code2/

作者：依樂祝（祝雷）

出處：https://www.cnblogs.com/yilezhu

聯系：[email protected] .NET Core實戰項目交流群：637326624 微信：jkingzhu

本文版權歸作者和部落格園共有，歡迎轉載，但未經作者同意必須保留此段聲明，且在文章頁面明顯位置給出原文連接配接，否則保留追究法律責任的權利。如有問題或建議，請多多賜教，非常感謝。