如何配置开发 ASP.NET Core 项目的 VS Code 环境

Visual Studio Code (以下简称 VSCode) 是一个功能非常强大的 IDE, 我感觉甚至比 Visual Studio 还要好用! 接下来，就让我们来看看如何使用其来开发 .NET Core 项目。

自从 .NET 5.0 以后就可以支持跨平台开发，并且主要也是基于 Core 的架构，同时也可以支持直接使用 VSCode 进行开发。以下就先介绍一下我为什么要选择 VSCode 吧 :smiley:

1. 选择 VSCode 的原因

VSCode 是一款轻量级的代码编辑器，并且有着以下超越了 Visual Studio（以下简称 VS） 的好处：

1.1 轻量级且快速

VSCode 比起 VS 的庞大体积来简直是不值一提，但正是因为如此，其启动和运行速度也比 VS 要快了许多，但其功能也绝不逊色。

1.2 支持多平台

VSCode 是基于 Electron 开发的，所以其可以运行在多种平台下，包括 Windows, macOS 和 Linux 等，这就让开发者可以方便地在不同平台下使用相同的开发环境进行开发，对于经常要在不同平台下工作的开发者来说，这无疑是非常方便的。

1.3 强大的扩展性

VSCode 提供了非常丰富的扩展包，可以根据开发需求自由扩展功能。 开发人员可以根据自己的需求安装各种语言支持，代码片段，主题和其他扩展，以使编辑器更符合个人喜好和工作流程。 这就是我非常喜欢它的原因之一！ 通过各种扩展，可以极大地提高发展效率，而这对于 VS 来说是一个不小的短板。

1.4 丰富的主题

尽管这不是一个必要的需求，但我不得不说这也是一个在很大程度上我使用 VSCode 的原因之一。 一款好的主题，会让代码看起来非常舒适。 毕竟，你将会花费很长的时间与其一起工作，所以你当然应该要让自己的眼睛舒服点，一款好主题，也会让你的心情变得更好 :laughing:

1.5 集成了版本控制

VSCode 本身就集成了 Git 的版本控制功能，可以直接使用图形界面进行管理和操作，同时如果配合相关扩展，将会如虎添翼，虽然 VS 也有 Git 集成，但却没有强大的扩展支持，功能就比较单调了些。

1.6 集成了终端

VSCode 直接可使用终端，允许开发者直接在编辑器里执行终端命令，如启动服务器和执行测试等。这功能也极大地提高了开发效率，特别是当开发 .Net Core 和 Angular 这类项目时，很多时候需要使用命令行以执行项目的编译、启动和发布等，这时就非常方便了！

1.7 生态系统支持

VSCode 是一个开源并且拥有强大用户社区的项目，所以有大量的使用技巧指南和解决方案，也有很多可用的资源。开发者可以很容易找到相关资源，甚至如果发现有问题可直接到社区提交，很快就会有人帮助，这就是开源项目的好处之一，而其强大的社区也反过来加强和影响了其功能的改进和 bugs 的修复，版本更新速度快，因此会不断有新功能推出和改进。

1.8 支持多语言开发

VSCode 另一强大之处是只需安装相应的扩展，就可以支持多种编程语言的开发。如同时开发 .Net Core 与 Angular，其对 Angular 也有非常好的支持，这样就不需要在不同 IDE 里切换就可以完成一个复杂的项目，同时也节省了很多系统资源。

2. 配置 .Net Core 开发环境

2.1 安装 SDK

如果你之前并未安装过 VS 也没开发过相关的 .Net 项目，那么首先要做的就是到微软官网下载相关的 SDK

https://dotnet.microsoft.com/en-us/download

2.2 安装扩展

为了更好地支持 .NET Core 的开发，需要安装以下的扩展：

1) DotNet Core Essentials

通过此扩展，你可以直接在 VSCode 进行编译、创建和添加引用到你的项目中，非常方便。

2) C# Extensions

此扩展可为你提供多个建立 .Net 项目文件的模板。如你建立一个类或者接口时，其可自动为你生成相关的结构文件。

3) vscode-solution-explorer

这是一个功能强大的扩展，可以让你像在 VS 一样地在 VSCode 里操作你的 .Net 项目。你可以通过解决方案来查看和管理项目的文件夹，就像在 VS 里一样，然后点击右键，在弹出菜单中进行相关的操作。

安装此扩展后，你会看到在左侧栏多了一个 VS 解决方案的图标，点击后就可查看到当前解决方案的结构。

4) NuGet Package Manager GUI

开发 .Net 的朋友都应该知道 NuGet，这个扩展可以让你方便地进行管理和安装 NuGet 包，界面非常友好，感觉比 VS 自带的管理功能还要好用哦！

OK，对于开发 .Net Core 项目，以上介绍几个扩展已够了，当然还会有更多好用的相关扩展，大家可以自行尝试和研究 :smiley:

3. 创建项目

接下来，就让我们尝试使用 VSCode 来创建一个完整的 .Net Core 项目吧！

3.1 创建一个空文件夹

例如，我们创建一个名为 MyDemo_001 的文件夹，然后直接拖拽到 VSCode 里，之后再打开 VSCode 的终端

• MacOS:

CMD + Shift + ` 

• Windows:

CTRL + Shift + ` 

3.2 使用 vscode-solution-explorer 创建项目

点左侧栏的解决方案图标

建立新的解决方案（Create New Solution），名称就叫 MyDemo001

然后右键点击解决方案名称，建立新的项目

此时会看到有很多模板可供选择，我们选择 ASP.NET Core Web App

然后会提示输入项目名称和文件夹，这时都使用 WebDemo 即可，完成后就会看到生成了以下项目结构

4. 测试和运行项目

最后一步就是测试我们的项目是否可正常运行了。这里有2种方式运行项目，一种是直接使用终端，输入相关的命令以启动项目，而另一种则是以调试的方式启动，可以对源码进行逐步调试。现在我们分别来尝试这2种方式：

4.1 以命令行启动

Open the project directory in the terminal, in my example above, it is MyDemo\MyDemo.API, and then execute the following command:

打开 VSCode 终端，然后输入以下命令以进入 WebDemo 项目的文件夹

cd WebDemo

然后运行以下命令以启动项目

dotnet watch run

这里使用了 watch 是为了方便观察源码的变动，即只要修改了源码后，就会自动重新生成项目并更新到浏览器，达到了热更新的效果。（这一功能在 VS 里也是没有的哦）

如一切正常的话，运行后就会自动打开浏览器显示以下画面了

4.2 以调试模式启动

Click the debug button on the left side, click the Run and Debug button, then several options will pop up, just choose the first .Net 5+ and .Net Core, and then will automatically create a debugger for your require with configuration file

如果你想设置断点并以调试模式启动，可点击左侧栏的调试图标

然后很快你将看到 VSCode 会自动帮你下载相关的组件，之后只需点击 Run and Debug 按钮，会让你选择调试的语言，直接选择 c#，最后选择以哪种配置进行调试，选择第一个默认的即可

当项目启动后，就会进入之前设置的断点

这时可通过右上解的调试工具进行调试

运行完后，将会看到与上图命令行方式启动后一样的网页效果了。

5. 总结

以上就是使用 VSCode 进行开发 .Net Core 的全部流程，可以看到整个过程也是非常简单方便地，在 VS 里有的功能几乎都能在 VSCode 实现，而且通过强大的扩展，做起来会更加地方便，同时也会对你的开发效率有很大提高。现在就来尝试一下吧 :smirk:

相关文章：

使用 VS CODE 建立你的第一个 ASP.NET Core API 项目 VSCode 常用快捷键，扩展推荐和 Flutter 开发的配置