使用 VS Code 開發和調試 .NET Core 程序

電腦不想裝幾十個G的 VS2017，那就用 VS Code 吧

目標：

• 建立一個類庫項目 Skany.Core，並用 Nuget 引用第三方組件 Hash 實現加密算法
• 建立一個單元測試項目 Skany.Tests，引用類庫 Skany.Core，並測試其中的方法
• 建立一個控制檯應用程序項目 Skany.Output，引用類庫 Skany.Core，並輸出方法執行結果
• 建立一個解決方案 Skany.sln，包括以上三項目

環境

• .NET Core SDK 2.2.202

開始

首先在 VS Code 安裝幾個擴展插件

C#
C# Extensions
.NET Core Test Explorer

這三個插件就能夠作最基礎的開發了

構建項目

建立解決方案文件夾 C:\Here\Skany
在 VS Code 中打開這個文件夾
在 VS Code 中打開終端（也能夠在外部使用cmd或powershell）
接下來將使用 .NET Core CLI 命令建立項目

# 建立類庫項目
dotnet new classlib -n Skany.Core
# 建立控制檯應用程序
dotnet new console -n Skany.Output
# 建立xUnit單元測試項目
dotnet new xunit -n Skany.Tests
# 爲 Output 添加 Core 引用（由於當前在解決方案目錄，而不是項目目錄，因此add後要加上項目名，如下同理）
dotnet add Skany.Output reference Skany.Core
# 爲 Tests 添加 Core 引用
dotnet add Skany.Tests reference Skany.Core
# 爲 Core 項目添加 Nuget 引用
dotnet add Skany.Core package Hash --version 4.0.0
# 建立解決方案 sln
dotnet new sln -n Skany
# 添加項目到解決方案
dotnet sln Skany.sln add Skany.Core
dotnet sln Skany.sln add Skany.Output
dotnet sln Skany.sln add Skany.Tests
# 編譯一下 Output 和 Tests 項目
dotnet build Skany.Output
dotnet build Skany.Tests

當不熟悉命令時，均可以經過 -h 或 --help 參數獲取幫助，好比我不知道單元測試項目的參數，就輸入 dotnet new -h 查看 new 的選項
注：其實用第三方插件（好比 vscode-solution-explorer）輕鬆實現以上命令的可視化操做，這裏只是演示 .NET Core CLI 命令用法

建立完後的項目結構

 SKANY
 | Skany.Core
   | Class1.cs
   | Skany.Core.csproj
 | Skany.Output
   | Program.cs
   | Skany.Output.csproj
 | Skany.Tests
   | UnitTest1.cs
   | Skany.Tests.csproj
 | Skany.sln

將 Core 項目中的 Class1.cs 改成 CryptHelper.cs，代碼以下

using HashLibrary;

namespace Skany.Core
{
    public class CryptHelper
    {
        public static string HashPassword(string password, out string salt)
        {
            var hash = HashedPassword.New(password, hashLength: 50, saltLength: 10);
            salt = hash.Salt;
            return hash.Hash;
        }
        
        public static bool VerifyPassword(string password, string hashPassword, string salt)
        {
            var hash = new HashedPassword(hashPassword, salt);
            bool matches = hash.Check(password);
            return matches;
        }
    }
}

在 Tests 項目中別寫測試案例，將 UnitTest1.cs 改成 CryptUnitTest.cs，代碼以下

using System;
using Xunit;

namespace Skany.Tests
{
    using Core;

    public class CryptUnitTest
    {
        [Theory]
        [InlineData("zhang")]
        [InlineData("baidu")]
        public void HashPasswordTest(string password)
        {
            string salt;
            var hashPassword = CryptHelper.HashPassword(password, out salt);
            Assert.NotNull(hashPassword);
            Assert.NotNull(salt);
            Assert.True(hashPassword.Length == CryptHelper.HashLength);
            Assert.True(salt.Length == CryptHelper.SaltLength);
            VerifyPasswordTest(password, hashPassword, salt);            
        }

        [Theory]
        [InlineData("zhang", "ÁēÕĀ1fv¾ĒëÜĝ}f§¼kÈ$Æ7KĎĞĐMĬZĝČ9ËÅ«¢ÝĪÙØê£İ)¥jµQIįa", "ïÛŀB³äĭonÊ")]
        [InlineData("baidu", " g©®Ģ¹Óäõ¥ģH»7ċuO¸%AOĮ©ĩ§8ĆKĄöĉĖß$µåˬüÖ=ĝĴ¶Cꨧh/", "ĀĖ§į^H7Í_h")]
        public void VerifyPasswordTest(string password, string hashPassword, string salt)
        {
            Assert.True(hashPassword.Length == CryptHelper.HashLength);
            Assert.True(salt.Length == CryptHelper.SaltLength);
            Assert.True(CryptHelper.VerifyPassword(password, hashPassword, salt));
        }
    }
}

單元測試

經過命令執行單元測試

dotnet test Skany.Tests

若是隻想測試其中一個方法 HashPasswordTest

dotnet test Skany.Tests --filter HashPasswordTest

固然有可視化的測試插件，誰還用命令啊

控制檯應用程序

在 Output 項目調用 Core.CryptHelper 輸出結果，代碼以下

static void Main(string[] args)
{
     string salt = null;
     var password = "baidu";
     var hashPassword = CryptHelper.HashPassword(password, out salt);
     Console.WriteLine("Password => {0}", password);
     Console.WriteLine("HashPassword => {0}", hashPassword);
     Console.WriteLine("Salt => {0}", salt);

     //===================================

     var matchs = CryptHelper.VerifyPassword(password, hashPassword, salt);
     Console.WriteLine("Matchs: {0}", matchs);
     Console.ReadLine();
}

運行 Output 項目

dotnet run --project Skany.Output

斷點調試

在 Output/Program.cs 中第13行設置一個端點（鼠標在行首點一下便可，再點一下移除斷點）

DEBUG面板配置選擇 .NET Core Launch (console)，點擊綠色的開始調試按鈕，啓動調試

與 VS 中同樣，能夠經過 F5/F10/F11 控制調試流程，也能夠添加 Watch 變量，鼠標也能夠感知變量值

若是開始測試後，警告提示啓動程序找不到，能夠按提示（也能夠點擊界面齒輪按鈕）修改配置文件 .vscode/launch.json
覈對 program 節點路徑是否正確

發佈

VS 中用工具發佈，發佈參數配置在 *Profile.pubxml，但 VS Code 中只能用命令

# 發佈Release配置，包括 .net core 運行時，分別發佈到 linux 和 windows
dotnet publish -c Release --self-contained -r linux-x64
dotnet publish -c Release --self-contained -r win-x64

# 發佈Release配置，包括 .net core 運行時，指定目標框架 netcoreapp2.2
dotnet publish -c Release -f netcoreapp2.2 --self-contained -r linux-x64
dotnet publish -c Release -f netcoreapp2.2 --self-contained -r win-x64

# 發佈Release配置，不包括 .net core 運行時
dotnet publish -c Release --self-contained false -r linux-x64
dotnet publish -c Release --self-contained false -r win-x64

# 發佈Release配置，不包括 .net core 運行時，指定輸出目錄
dotnet publish -c Release --self-contained false -r linux-x64 -o C:\Here\Spany\publish\linux-x64
dotnet publish -c Release --self-contained false -r win-x64 -o C:\Here\Spany\publish\win-x64

雖然 VS 無比強大，VS Code 小清醒，可是 VS Code 靈活擴展性強，用來開發前端或 .NET Core 項目，也是駕輕就熟