Get Started with C# and Visual Studio Code
.NET Core gives you a fast and modular platform for creating applications that run on Windows, Linux, and macOS. 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.
- Install Visual Studio Code.
- Install the .NET Core SDK.
- Install the C# extension for Visual Studio Code. For more information about how to install extensions on Visual Studio Code, see VS Code Extension Marketplace.
Let's get started with a simple "Hello World" program on .NET Core:
Open a project:
Open Visual Studio Code.
Click on the Explorer icon on the left menu and then click Open Folder.
Select File > Open Folder from the main menu to open the folder you want your C# project to be in and click Select Folder. For our example, we're creating a folder for our project named HelloWorld.
Initialize a C# project:
Open the Integrated Terminal from Visual Studio Code by selecting View > Integrated Terminal from the main menu.
In the terminal window, type
dotnet new console.
This command creates a
Program.csfile in your folder with a simple "Hello World" program already written, along with a C# project file named
Resolve the build assets:
For .NET Core 1.x, type
dotnet restore. Running
dotnet restoregives you access to the required .NET Core packages that are needed to build your project.
Starting with .NET Core 2.0, you don't have to run
dotnet restorebecause it's run implicitly by all commands that require a restore to occur, such as
dotnet run. 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.
Run the "Hello World" program:
Open Program.cs by clicking on it. The first time you open a C# file in Visual Studio Code, OmniSharp loads in the editor.
Visual Studio Code should prompt you to add the missing assets to build and debug your app. Select Yes.
To open the Debug view, click on the Debugging icon on the left side menu.
Locate the green arrow at the top of the pane. Make sure the drop-down next to it has
.NET Core Launch (console)selected.
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.
To start debugging, select F5 or 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.
Select the green arrow at the top to continue debugging, or select the red square at the top to stop.
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.
I'm missing required assets to build and debug C# in Visual Studio Code. My debugger says "No Configuration."
The Visual Studio Code C# extension can generate assets to build and debug for you. Visual Studio Code prompts you to generate these assets when you first open a C# project. 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". Selecting this generates the .vscode, launch.json, and tasks.json configuration files that you need.