Начало работы с C# и Visual Studio CodeGet started with C# and Visual Studio Code

.NET Core предcтавляет собой быструю модульную платформу для создания приложений, работающих на ОС Windows, Linux и macOS..NET Core gives you a fast and modular platform for creating applications that run on Windows, Linux, and macOS. Visual Studio Code с расширением C# позволяет эффективно работать с кодом, а также обеспечивает полную поддержку IntelliSense (интеллектуальное завершение кода) и отладки для языка C#.Use Visual Studio Code with the C# extension to get a powerful editing experience with full support for C# IntelliSense (smart code completion) and debugging.

Предварительные требованияPrerequisites

  1. Установите Visual Studio Code.Install Visual Studio Code.
  2. Установите пакета SDK для .NET Core.Install the .NET Core SDK.
  3. Установите расширение C# для Visual Studio Code.Install the C# extension for Visual Studio Code. См. дополнительные сведения об установке расширений Visual Studio Code из Marketplace.For more information about how to install extensions on Visual Studio Code, see VS Code Extension Marketplace.

Hello WorldHello World

Давайте начнем с создания простой программы Hello World для .NET Core.Let's get started with a simple "Hello World" program on .NET Core:

  1. Откройте проект.Open a project:

    • Откройте Visual Studio Code.Open Visual Studio Code.

    • Щелкните значок обозревателя в расположенном слева меню, затем щелкнитеОткрыть папку.Click on the Explorer icon on the left menu and then click Open Folder.

    • Выберите Файл > Открыть папку в главном меню, чтобы открыть папку, в которой вы хотите разместить проект C#, и щелкните Выбрать папку.Select File > Open Folder from the main menu to open the folder you want your C# project to be in and click Select Folder. В нашем примере мы создаем для проекта папку с именем HelloWorld.For our example, we're creating a folder for our project named HelloWorld.

      Кнопка "Открыть папку" в Visual Studio Code

  2. Инициализируйте проект C#.Initialize a C# project:

    • Откройте в Visual Studio Code интегрированный терминал, выбрав Просмотр > Интегрированный терминал в главном меню.Open the Integrated Terminal from Visual Studio Code by selecting View > Integrated Terminal from the main menu.

    • В окне терминала введите dotnet new console.In the terminal window, type dotnet new console.

    • Эта команда создает в выбранной папке файл Program.cs с уже готовой простой программой Hello World, а также файл проекта C# с именем HelloWorld.csproj.This command creates a Program.cs file in your folder with a simple "Hello World" program already written, along with a C# project file named HelloWorld.csproj.

      Команда dotnet new

  3. Выполните разрешение для средств сборки:Resolve the build assets:

    • Для .NET Core 1.x введите dotnet restore.For .NET Core 1.x, type dotnet restore. Команда dotnet restore предоставляет доступ к пакетам .NET Core, которые необходимы для сборки этого проекта.Running dotnet restore gives you access to the required .NET Core packages that are needed to build your project.

      Команда dotnet restore

      Примечание

      Начиная с пакета SDK для .NET Core 2.0 нет необходимости выполнять команду dotnet restore, так как она выполняется неявно всеми командами, которые требуют восстановления, например dotnet new, dotnet build и dotnet run.Starting with .NET Core 2.0 SDK, you don't have to run dotnet restore because it's run implicitly by all commands that require a restore to occur, such as dotnet new, dotnet build and dotnet run. Эту команду по-прежнему можно использовать в некоторых сценариях, где необходимо явное восстановление, например в сборках с использованием непрерывной интеграции в Azure DevOps Services или системах сборки, где требуется явно контролировать время восстановления.It's still a valid command in certain scenarios where doing an explicit restore makes sense, such as continuous integration builds in Azure DevOps Services or in build systems that need to explicitly control the time at which the restore occurs.

  4. Запустите программу Hello World.Run the "Hello World" program:

    • Введите dotnet run.Type dotnet run.

      Команда dotnet run

Вы можете просмотреть небольшие видеоматериалы с информацией о процессе настройки для Windows, macOS, или Linux.You can also watch a short video tutorial for further setup help on Windows, macOS, or Linux.

ОтладкаDebug

  1. Откройте файл Program.cs, щелкнув его.Open Program.cs by clicking on it. Когда вы в первый раз открываете файл C# в Visual Studio Code, в редакторе загружается OmniSharp.The first time you open a C# file in Visual Studio Code, OmniSharp loads in the editor.

    Откройте файл Program.cs

  2. Visual Studio Code предлагает добавить недостающие ресурсы для сборки и отладки приложения.Visual Studio Code should prompt you to add the missing assets to build and debug your app. Выберите ответ Да.Select Yes.

    Предупреждение о недостающих ресурсах

  3. Чтобы открыть окно отладки, щелкните значок "Отладка" в меню слева.To open the Debug view, click on the Debugging icon on the left side menu.

    Откройте вкладку "Отладка" в Visual Studio Code

  4. Найдите зеленую стрелку в верхней части панели.Locate the green arrow at the top of the pane. Убедитесь, что в раскрывающемся списке рядом с ней выбран вариант Запуск .NET Core (консоль) .Make sure the drop-down next to it has .NET Core Launch (console) selected.

    Выбор .NET Core в Visual Studio Code

  5. Добавьте в проект точку останова, щелкнув поле редактора (пустое пространство слева от номеров строк) в строке 9, или переместите курсор текста в строку 9 в редакторе и нажмите клавишу F9.Add a breakpoint to your project by clicking on the editor margin, which is the space on the left of the line numbers in the editor, next to line 9, or move the text cursor onto line 9 in the editor and press F9.

    Установка точки останова

  6. Чтобы начать отладку, нажмите клавишу F5 или щелкните зеленую стрелку.To start debugging, press F5 or select the green arrow. Отладчик останавливает выполнение программы, когда достигнет точки останова, которую вы только что установили.The debugger stops execution of your program when it reaches the breakpoint you set in the previous step.

    • Во время отладки вы можете просматривать локальные переменные в верхней левой области или в консоли отладки.While debugging, you can view your local variables in the top-left pane or use the debug console.
  7. Выберите синюю стрелку в верхней части, чтобы продолжить отладку, или выберите красный квадрат в верхней части, чтобы остановить процесс.Select the blue arrow at the top to continue debugging, or select the red square at the top to stop.

    Запуск и отладка в Visual Studio Code

Совет

Дополнительные сведения и советы по отладке .NET Core в Visual Studio Code с помощью OmniSharp см. в разделе Инструкции по настройке отладчика .NET Core.For more information and troubleshooting tips on .NET Core debugging with OmniSharp in Visual Studio Code, see Instructions for setting up the .NET Core debugger.

Добавление классаAdd a class

  1. Чтобы добавить новый класс, щелкните правой кнопкой мыши в обозревателе VS Code и выберите Новый файл.To add a new class, right-click in the VSCode Explorer and select New File. Так вы добавите новый файл в папку, открытую в VSCode.This adds a new file to the folder you have open in VSCode.

  2. Назовите файл MyClass.cs.Name your file MyClass.cs. Необходимо сохранить его с расширением .cs, чтобы он распознавался как файл С#.You must save it with a .cs extension at the end for it to be recognized as a csharp file.

  3. Добавьте приведенный ниже код для создания класса.Add the code below to create your first class. Включите правильное пространство имен, на которое будет создана ссылка из файла Program.cs:Make sure to include the correct namespace so you can reference it from your Program.cs file:

    using System;
    
    namespace HelloWorld
    {
        public class MyClass
        {
            public string ReturnMessage()
            {
                return "Happy coding!";
            }
        }
    }
    
  4. Вызовите новый класс из метода main в Program.cs, добавив приведенный ниже код:Call your new class from your main method in Program.cs by adding the code below:

    using System;
    
    namespace HelloWorld
    {
        class Program
        {
            static void Main(string[] args)
            {
                var c1 = new MyClass();
                Console.WriteLine($"Hello World! {c1.ReturnMessage()}");
            }
        }
    }
    
  5. Сохраните изменения и снова запустите программу.Save your changes and run your program again. Должно отобразиться новое сообщение с добавленной строкой.The new message should appear with the appended string.

    dotnet run
    

    Вы получите следующие выходные данные:You get the following output:

    Hello World! Happy coding!
    

часто задаваемые вопросыFAQ

Мне не хватает ресурсов для выполнения сборки и отладки C# в Visual Studio Code.I'm missing required assets to build and debug C# in Visual Studio Code. Отладчик выдает сообщение: "Конфигурация отсутствует".My debugger says "No Configuration."

Ресурсы для сборки и отладки можно создать с помощью расширения Visual Studio Code C#.The Visual Studio Code C# extension can generate assets to build and debug for you. Visual Studio Code предложит создать эти ресурсы при первом открытии проекта C#.Visual Studio Code prompts you to generate these assets when you first open a C# project. Если вы не создали ресурсы, вы все равно сможете выполнить эту команду. Для этого откройте палитру команд (Вид > Палитра команд) и введите ">.NET: Generate Assets for Build and Debug" (.NET: создать ресурсы для сборки и отладки).If you didn't generate assets then, you can still run this command by opening the Command Palette (View > Command Palette) and typing ">.NET: Generate Assets for Build and Debug". После этого будут созданы необходимые файлы конфигурации .vscode, launch.json и tasks.json.Selecting this generates the .vscode, launch.json, and tasks.json configuration files that you need.

См. такжеSee also