安裝插件

使用VSCode編寫dotnet core項目除了其 默認的功能外，我推薦還要安裝一些非常有特色，并且有用的擴展，正是因為VSCode的插件機制，才讓它變得更加強大，滿足我們各式各樣的需求。

1、C#語言擴展

這個是使用VSCode編寫C#代碼必須的，安裝之后在默認打開.cs文件時還會自動下載調(diào)試器等。

2、[C# XML注釋]

這個插件可以快速的幫你添加注釋，選擇安裝吧。

3、[C# Extensions]

這個插件，強烈推薦，可以幫你在建立文件的時候初始化文件內(nèi)容包括對應(yīng)的命名空間等。

還有一些其他輔助類的，比如EditorConfig,Guildes,One Dark Theme,Project Manager ,Setting Sync等。

新建多項目解決方案

打開命令行工具，在命令行工具中輸入：

$:> dotnet new sln -o vscode_tutorial //在當前目錄下 創(chuàng)建名為vscode_tutorial

以上命令使用dotnet sdk，新建一個解決方案文件，你可以不用命令行手動創(chuàng)建，但是使用dotnet new 可以更加方便的創(chuàng)建dotnet core相關(guān)的項目，如下圖所示：

建完解決方案我們要來建立項目了，包括一個控制臺項目，一個類庫項目和一個單元測試項目。

首先建立一個公共的類庫項目用于存放我們的業(yè)務(wù)方法（假設(shè)我們在做一個真實的項目）（注意，這時已經(jīng)cd進sln目錄里了）

$:> dotnet new classlib -o VSCodeTutorial.Common //在當前目錄下新建類庫項目VSCodeTutorial.Common $:> dotnet sln add VSCodeTutorial.Common/VSCodeTutorial.Common.csproj //將項目添加到解決方案中

通過同樣的方式，我們建立好控制臺項目和單元測試項目

$:> dotnet new console -o VSCodeTutorial.ConsoleApp $:> dotnet sln add VSCodeTutorial.ConsoleApp/VSCodeTutorial.ConsoleApp.csproj $:> dotnet new xunit -o VSCodeTutorial.UnitTest $:> dotnet sln add VSCodeTutorail.UnitTest/VSCodeTutorial.UnitTest.csproj

這里要注意控制的模板名稱叫console，而單元測試我們使用xunit。

這個時候我們的項目結(jié)構(gòu)已經(jīng)建立完成了，我們用VsCode來打開當前目錄來看看完成的項目結(jié)構(gòu)吧，如下圖所示：

添加項目間的依賴關(guān)系

使用VsCode打開項目文件VSCodeTutorial.ConsoleApp.csproj,在其中添加對Common項目的引用

<Project Sdk="Microsoft.NET.Sdk">   <PropertyGroup>     <OutputType>Exe</OutputType>     <TargetFramework>netcoreapp1.1</TargetFramework>   </PropertyGroup>  <!--添加項目引用-->   <ItemGroup>     <ProjectReference Include="..VSCodeTutorial.CommonVSCodeTutorial.Common.csproj" />   </ItemGroup></Project>

同樣打開VSCodeTutorial.UnitTest.csproj項目文件，在其中添加對Common項目的引用

<Project Sdk="Microsoft.NET.Sdk">   <PropertyGroup>     <TargetFramework>netcoreapp1.1</TargetFramework>   </PropertyGroup><!--nuget 上的類庫引用-->   <ItemGroup>     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="15.0.0" />     <PackageReference Include="xunit" Version="2.2.0" />     <PackageReference Include="xunit.runner.visualstudio" Version="2.2.0" />   </ItemGroup><!--本地項目引用-->  <ItemGroup>     <ProjectReference Include="..VSCodeTutorial.CommonVSCodeTutorial.Common.csproj" />   </ItemGroup></Project>

和上面的那個項目不同，這里有一些額外的依賴，這里可以剛好了解下，如果添加nuget中包的依賴，只需像上面一樣使用PackageReference并填入類庫名稱和版本號即可。

添加完依賴后，我們在根目錄下使用dotnet restore來初始化一下，也可以再用dotnet build命令來嘗試編譯一下。

項目依賴關(guān)系如圖2：

開始編寫代碼

這個項目的整體需求：我需要打開一個控制臺程序，運行時需要用戶輸入一個小于50的整數(shù)，控制臺接收到這個數(shù)字后計算出這個數(shù)字的階乘，并把結(jié)果輸出到控制臺上。

經(jīng)過簡單的思考，我決定把階乘的實現(xiàn)放到Common項目中，并且對其進行單元測試，測試的代碼則放到UnitTest項目中

首先我們把之前生成的項目中不需要的文件給刪除掉VsCodeTutorial.Common中的Class1.cs和VSCodeTutorial.UnitTest中的UnitTest1.cs ，當然你也可以留著。

第一步，我們在VsCodeTutorial.Common項目中新建文件MathHelper.cs并在文件中添加如下代碼,實現(xiàn)我們的階乘，代碼比較簡單就不詳述了。

namespace VSCodeTutorial.Common{     public class MathHelper     {        /// <summary>         /// 階乘，本例中暫不考慮 溢出的問題哦 Factorial(n) = n*（n-1）*(n-2)...*1;         /// </summary>         /// <param name="n">輸入?yún)?shù)n</param>         /// <returns></returns>         public static int Factorial(int n){            if(n <=0 ){                 throw new System.ArgumentOutOfRangeException("n","參數(shù)錯誤，不能小于等于零");             }            if(n == 1){                return 1;             }            return n*Factorial(n-1);         }     } }

第二步，我們要來測試這個代碼，看看是否達到了我們的目標，在VSCodeTutorial.UnitTest項目中新建文件MathHelpTest.cs向文件中添加測試Factorial函數(shù)的方法，如下所示：

using System; using VSCodeTutorial.Common; using Xunit; namespace VSCodeTutorial.UnitTest{     public class MathHelperTest     {          [Fact]         public void TestFactorial()        {            //先測試一下邊界的情況             int zero = 0 ;             var exception = Assert.Throws<ArgumentOutOfRangeException>(() => MathHelper.Factorial(zero));             int one = 1;             var oneResult = MathHelper.Factorial(one);             Assert.Equal(1, oneResult);            //再測一下正常的情況             int five = 5;             var fiveResult = MathHelper.Factorial(five);             Assert.Equal(5*4*3*2*1, fiveResult);             int ten = 10;             var tenResult = MathHelper.Factorial(ten);             Assert.Equal(10*9*8*7*6*5*4*3*2*1, tenResult);         }     } }

使用命令行運行單元測試

在使用配置VSCode之前 我還是建議大家先使用命令行來運行一下單元測試，這有利于更好的理解配置內(nèi)容。

在根目錄下輸入命令:dotnet test ./VSCodeTutorial.UnitTest/VSCodeTutorial.UnitTest.csproj 查看運行結(jié)果：

很差勁會出現(xiàn)編碼錯誤，而且這個錯誤暫時還沒有辦法解決..但是我猜單元測試通過了，這個問題相信在后續(xù)的版本中肯定會得到解決，事實上在Console項目中是可以解決輸出亂碼問題的。不過可喜的是在VSCode中運行單元測試是沒有亂碼的問題的。

使用VSCode 運行單元測試

首先當你打開項目的時候，VSCode 可能已經(jīng)建議你配置一下相關(guān)的內(nèi)容，如下圖所示:

選擇Yes, 會幫你新建這個一個目錄和兩個文件，luanch.json是用來執(zhí)行調(diào)試程序的配置，而tasks.json則是配置各種任務(wù)的，其中運行單元測試就是一種任務(wù)。

首先我們打開tasks.json ，默認已經(jīng)添加好了一個任務(wù)，如下所示：

{     "version": "0.1.0",     "command": "dotnet", //全局命令，即所有的任務(wù)都使用這個命令，也可以在各個任務(wù)中設(shè)置     "isShellCommand": true,     "args": [],     "tasks": [         {             "taskName": "build", //任務(wù)名稱 當設(shè)置了主的command 之后這個taskName也會作為一個命令參數(shù)             "args": [                 "${workspaceRoot}\VSCodeTutorial.ConsoleApp\VSCodeTutorial.ConsoleApp.csproj"             ],             "isBuildCommand": true,  //一個解決方案只能設(shè)置一個編譯任務(wù)，多設(shè)置了也是白搭，當然也能執(zhí)行，只是不能利用快捷方式運行了            "problemMatcher": "$msCompile"//C#項目的problemMatcher         }     ]}

默認使用了全局命令行，這樣可以在任務(wù)中省去配置dotnet命令，但是如果你的解決方案中包括多個項目需要不同的命令行編譯方式，如果前端網(wǎng)站使用grunt打包資源，那么頂部應(yīng)該留空，而在各個子任務(wù)中配置command。

還有如果存在多個編譯項目時（如客戶端和服務(wù)端在一個解決方案時），也應(yīng)該把command配置在子任務(wù)中，并設(shè)置個性化的taskName以便區(qū)別，所以我推薦把command設(shè)置在任務(wù)中，下面我們修改一下以上代碼，并添加一個運行單元測試的人。

{     "version": "0.1.0",     "isShellCommand": true,     "args": [],     "tasks": [         {            "taskName": "build_console",             "command":"dotnet"             "args": [                 "build", //組成dotnet build                 //設(shè)置需要編譯的項目，如果存在多個啟動項目可以設(shè)置成解決方案文件（.sln）,這里只有一個項目所以設(shè)置運行項目也可以                 "${workspaceRoot}\VSCodeTutorial.ConsoleApp\VSCodeTutorial.ConsoleApp.csproj"             ],             "isBuildCommand": true, //設(shè)置是否編譯項目             "problemMatcher": "$msCompile"         },         {             "taskName": "UnitTest",             "command":"dotnet",             "args": [                 "test",//組成dotnet test 命令                 "${workspaceRoot}\VSCodeTutorial.UnitTest\VSCodeTutorial.UnitTest.csproj"             ],             "isTestCommand": true,//設(shè)置為單元測試項目            "problemMatcher": "$msCompile"         }     ]}

上面的代碼中，我將command命令移到了任務(wù)中，并給每個任務(wù)起了一個好識別的名字，現(xiàn)在這里一個有2個任務(wù)了

第一個任務(wù)build_console 運行時 會編譯VSCodeTutorial.ConsoleApp項目及其依賴的項目

第二個任務(wù)UnitTest則是單元測試項目，運行dotnet test命令，這里有個特殊的設(shè)置就是"isTestCommand": true 標識為測試項目后可以通過快捷方式運行該命令

任務(wù)建好了，我們來運行任務(wù)把，windows按下 ctrl+shift+p,在彈出的對話框中輸入:task 過濾命令可以得到以下的選項

選擇任務(wù):運行測試任務(wù) 這條來運行我們之前編寫好的單元測試項目，可以看到運行成功的情況，如下圖所示：

這里中文顯示正常，沒有亂碼哦，但是我不知道是什么原因..就是這么神奇

對于經(jīng)常執(zhí)行的任務(wù)，可以通過設(shè)置鍵盤快捷方式來方便調(diào)用，可以看到我分別設(shè)置了ctrl+shift+t 運行測試任務(wù)ctrl+shift+b 運行編譯任務(wù)，ctrl+shift+r 啟動選擇任務(wù)，大家可以根據(jù)自己的喜好來設(shè)置。

開始編寫控制臺代碼

打開VSCodeTutorial.ConsoleApp項目中的Program.cs文件，修改其中的代碼，如下所示：

using System; using VSCodeTutorial.Common; namespace VSCodeTutorial.ConsoleApp{     class Program     {         static void Main(string[] args)        {             while(true)             {                 Console.WriteLine("請輸入一個小于10的數(shù)字,回車結(jié)束:");                 string input_str = Console.ReadLine();                 if(int.TryParse(input_str ,out var input_int))                 {                     if(input_int>0 && input_int<=10){                        int result =  MathHelper.Factorial(input_int);                        Console.WriteLine("你輸入的數(shù)字是{0},它的階乘結(jié)果是{1},退出請按ctrl+c,按其他鍵再試一次", input_int,result);                        Console.ReadKey();                     }                 }                else{                     Console.WriteLine("輸入的字符不是有效的數(shù)字");                 }             }          }     } }

代碼比較 簡單，就不做解釋了，我們直接來看運行的結(jié)果，這里順便提一下啊，在我們之前做的眾多工作之后，我們這里編寫代碼有美美噠的智能提示哦，如下圖所示：

好，再根目錄下輸入以下命令運行ConsoleApp

$:> dotnet run -p ./VSCodeTutorial.ConsoleApp/VSCodeTutorial.ConsoleApp.csproj

也可以在VSCodeTutorial.ConsoleApp 目錄下直接運行dotnet run 命令即可.

結(jié)果運行還是亂碼中，但是這次我們有辦法解決，我們在控制臺代碼中添加一句代碼即可onsole.OutputEncoding = Encoding.UTF8

using System; using System.Text; using VSCodeTutorial.Common;namespace VSCodeTutorial.ConsoleApp{     class Program     {         static void Main(string[] args)        {             Console.OutputEncoding = Encoding.UTF8; // 設(shè)置控制臺編碼             while(true)             {                 Console.WriteLine("請輸入一個小于10的數(shù)字,回車結(jié)束:");                 string input_str = Console.ReadLine();                 if(int.TryParse(input_str ,out var input_int))                 {                     if(input_int>0 && input_int<=10){                        int result =  MathHelper.Factorial(input_int); Console.WriteLine("你輸入的數(shù)字是{0},它的階乘結(jié)果是{1},退出請按ctrl+c,按其他鍵再試一次",input_int,result);                        Console.ReadKey();                     }                 }                else{                     Console.WriteLine("輸入的字符不是有效的數(shù)字");                 }             }          }     } }

使用dotnet build編譯后，再次運行Console項目看到了我們期望的界面

程序運行正確，當然了，我們都跑過單元測試了不是。。

開始調(diào)試程序

如下圖提示操作：

終于輪到我們之前生成的launch.json文件出場了，先來看下它的代碼，代碼中已經(jīng)添加了配置的說明

{     "version": "0.2.0",     "configurations": [         {             "name": ".NET Core Launch (console)", //配置名稱 可以改成更好識別的名字             "type": "coreclr", // .net core類型的調(diào)試             "request": "launch", //調(diào)試方式 不用改             "preLaunchTask": "build", // 前置任務(wù)，這里是編譯，但是默認的編譯任務(wù)，已經(jīng)被我改了名字了，所以這里要改一下哦            "program": "${workspaceRoot}\VSCodeTutorial.ConsoleApp\bin\Debug\netcoreapp1.1\VSCodeTutorial.ConsoleApp.dll", //需要調(diào)試的DLL的位置  "args": [], //額外的參數(shù)             "cwd": "${workspaceRoot}\VSCodeTutorial.ConsoleApp", //工作目錄             "console": "internalConsole", //控制臺模式，這里是內(nèi)嵌控制臺，一會要改成外置的，不然沒法交互輸入             "stopAtEntry": false,             "internalConsoleOptions": "openOnSessionStart"         },         {             "name": ".NET Core Attach", //名稱             "type": "coreclr", //類型             "request": "attach", //使用附加的方式             "processId": "${command:pickProcess}" //附加的進程ID         }     ]}

根據(jù)實際情況，需要對上面的配置進行以下變更，變更的部分已經(jīng)添加了注釋，附加調(diào)試不是本文的重點，就不改了

{     "version": "0.2.0",     "configurations": [         {                     "name": "調(diào)試ConsoleApp", //修改下命令                     "type": "coreclr",                     "request": "launch",                     "preLaunchTask": "build_console", //修改前置任務(wù)名和task.json中配置一致                     "program": "${workspaceRoot}\VSCodeTutorial.ConsoleApp\bin\Debug\netcoreapp1.1\         VSCodeTutorial.ConsoleApp.dll",                     "args": [],                     "cwd": "${workspaceRoot}\VSCodeTutorial.ConsoleApp",                     "externalConsole":true, //使用外置的控制臺                     "stopAtEntry": false,                     "internalConsoleOptions": "openOnSessionStart"         },         {                     "name": ".NET Core Attach",                     "type": "coreclr",                     "request": "attach",                     "processId": "${command:pickProcess}"         }     ] }

修改完成后，我們點擊運行按鈕可以開始調(diào)試了，調(diào)試的方式和使用VS是一致的，快捷鍵為F5 F10 F11

完成！

相關(guān)文章教程推薦：vscode教程