如何使用VSCode开发和调试.NET Core程序
vscode有什么用
Visual Studio Code 是一个运行于 OS X，Windows和 Linux 之上的，针对于编写现代 web 和云应用的跨平台编辑器，它为开发者们提供了对多种编程语言的内置支持，并且正如 Microsoft 在Build 大会的 keynote 中所指出的，这款编辑器也会为这些语言都提供了丰富的代码补全和导航功能。
目标：
创建一个类库项目 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 项目，也是得心应手