C# 和 Visual Studio Code 入门Get started with C# and Visual Studio Code

本文内容

.NET Core 提供了快速运行的模块化平台，用于创建在 Windows、Linux 和 macOS 上运行的应用程序。带 C# 扩展的 Visual Studio Code 提供功能强大的编辑体验，完全支持 C# IntelliSense（智能代码填充）和调试。

系统必备Prerequisites

• 安装 Visual Studio Code。
• 获取 .NET Core SDK。
• 安装 Visual Studio Code 的 C# 扩展。若要详细了解如何在 Visual Studio Code 上安装扩展，请访问 VS Code 扩展市场。

Hello WorldHello World

让我们从 .NET Core 上的一个简单“Hello World”程序入手：

• 打开项目：

  • 打开 Visual Studio Code。

  • 依次单击左侧菜单上的“资源管理器”图标和 “打开文件夹” 。

  • 从主菜单中选择“文件” > “打开文件夹”，打开要在其中放置 C# 项目的文件夹，然后单击“选择文件夹” 。在我们的示例中，为项目创建名为“HelloWorld”的文件夹 。

• 初始化 C# 项目：

  • 通过从主菜单中选择“视图” > “集成终端” ，从 Visual Studio Code 中打开集成终端。

  • 在终端窗口中，键入“dotnet new console”。

  • 此命令在已编写“Hello World”简单程序的文件夹中创建 Program.cs 文件，以及 HelloWorld.csproj C# 项目文件。

• 解析生成资产：

  • 对于 .NET Core 1.x ，键入 dotnet restore。运行 dotnet restore 后，便有权访问生成项目所需的 .NET Core 包。

备注

从 .NET Core 2.0 SDK 开始，无需运行 dotnet restore，因为它由所有需要还原的命令隐式运行，如 dotnet new、dotnet build 和 dotnet run。在执行显式还原有意义的某些情况下，例如 Azure DevOps Services 中的持续集成生成中，或在需要显式控制还原发生时间的生成系统中，它仍然是有效的命令。

• 运行“Hello World”程序：

  • 键入 dotnet run。

还可以观看简短的视频教程，以获取更多关于在 Windows、macOS 或 Linux 上进行安装的帮助。

调试Debug

• 单击打开 Program.cs。在 Visual Studio Code 中首次打开 C# 文件时，会在编辑器中加载 OmniSharp。

• Visual Studio Code 会提示添加缺少的资产，以生成和调试应用。选择 “是” 。

• 若要打开调试视图，请单击左侧菜单上的“调试”图标。

• 找到窗格最上面的绿色箭头。请确保已选择旁边下拉列表中的“.NET Core Launch (console)”。

• 单击第 9 行旁边的编辑器边距 （编辑器中行号左侧的空间）或者将文本光标移动到编辑器中的第 9 行并按 F9，为项目添加断点。

• 要开始调试，请选择 F5 或绿色箭头。在到达你在上一步中设置的断点时，调试器会停止执行程序。

  • 调试时，可以在左上角的窗格中查看局部变量，也可以使用调试控制台进行查看。
• 选择最上面的蓝色箭头以继续调试，或选择最上面的红色方块以停止调试。

提示

若要详细了解如何使用 OmniSharp 在 Visual Studio Code 中进行 .NET Core 调试，以及相关的疑难解答提示，请参阅有关设置 .NET Core 调试器的说明。

添加类Add a class

• 若要添加一个新类，请右键单击 VSCode Explorer 并选择“新文件” 。此操作会将新文件添加到在 VSCode 中打开的文件夹中。

• 将文件命名为 MyClass.cs。必须在末尾使用 .cs 扩展名保存它，以便将其识别为 csharp 文件。

• 添加下面的代码，以创建第一个类。确保包括正确的命名空间，以便可以从 Program.cs 文件引用它。

using System;
namespace HelloWorld
{
    public class MyClass
    {
        public string ReturnMessage()
        {
            return "Happy coding!";
        }
    }
}

• 通过添加下面的代码，从 Program.cs 中的主要方法调用新类。

using System;
namespace HelloWorld
{
    class Program
    {
        static void Main(string[] args)
        {
            MyClass c1 = new MyClass();
            Console.WriteLine($"Hello World! {c1.ReturnMessage()}");
        }
    }
}

• 保存更改并再次运行程序。新消息应显示追加的字符串。

> dotnet run
Hello World! Happy coding!

FAQFAQ

缺少在 Visual Studio Code 中生成和调试 C# 所需的资产。I'm missing required assets to build and debug C# in Visual Studio Code. 调试器显示“无配置”。My debugger says "No Configuration."

Visual Studio Code C# 扩展可生成用于生成和调试的资产。首次打开 C# 项目时，Visual Studio Code 会提示用户生成这些资产。如果当时并未生成这些资产，仍可以通过打开命令面板（“视图”>“命令面板” ）并键入“>.NET：生成用于生成和调试的资产”来运行此命令。选择此方法可生成所需的 .vscode、launch.json 和 tasks.jsonn 配置文件。

请参阅See also

• 设置 Visual Studio Code
• 在 Visual Studio Code 中进行调试