Getting Started with C# in VS Code
This getting started guide introduces you to C# and .NET for Visual Studio Code through the following tasks:
- Installing and setting up your VS Code environment for C#.
- Writing and running a simple "Hello World" application using C#.
- Introduce you to other learning resources for C# in VS Code.
Keep in mind, that this guide won't teach you C#. Instead, it teaches you how to get set up for C# development in VS Code. If you're looking for resources to learn C#, check out our C# curriculum.
Necessary tools
- Visual Studio Code
- C# Dev Kit extension
- For .NET Development, the .NET SDK
Install
Installing VS Code and extensions
- If you haven't already done so, install VS Code.
- Next, install C# Dev Kit from the Visual Studio Marketplace. For additional details on installing extensions, read Extension Marketplace. The C# extension is called C# Dev Kit and it's published by Microsoft.
Note: C# Dev Kit supports cloud native development. To do cross-platform mobile and desktop development, you can use C# Dev Kit with the .NET MAUI extension. Learn how to get set up with .NET MAUI in VS Code.
Upon installation, C# Dev Kit launches an extension walkthrough. You can follow the steps of this walkthrough to learn more about the features of the C# extension. Reopen the walkthrough at any time by opening the Command Palette (⇧⌘P (Windows, Linux Ctrl+Shift+P)) and selecting Welcome: Open Walkthrough. Here, select Get Started with C# Dev Kit.
Note: You are required to sign in to a Visual Studio subscription to use C# Dev Kit. Check out the Signing in to C# Dev Kit documentation to learn more.
Open folder
By starting VS Code in a folder, that folder becomes your "workspace". VS Code stores settings that are specific to that workspace in .vscode/settings.json
, which are separate from user settings that are stored globally.
Using a terminal, create an empty folder called "hello", navigate into it, and open VS Code (code) in that folder (.) by entering the following commands:
mkdir hello
cd hello
code .
Alternatively, you can run VS Code through the operating system UI, then use File > Open Folder to open the project folder.
Create a Hello World app
First, ensure you are within the new folder (workspace) that you created. From here, you can create the project in two ways.
Use the Command Palette
- Bring up the Command Palette using ⇧⌘P (Windows, Linux Ctrl+Shift+P) and then type ".NET".
- Find and select the .NET: New Project command.
- After selecting the command, you'll need to choose the project template. Choose Console app.
- To run your app, select Run > Start Debugging in the upper menu, or use the F5 keyboard shortcut. To learn more about debugging your C# project, read the debugging documentation.
Use the terminal
-
Open a terminal/command prompt and navigate to the folder in which you'd like to create the app. Enter the following command in the command shell:
dotnet new console
-
When the project folder is first opened in VS Code:
A "Required assets to build and debug are missing. Add them?" notification appears at the bottom right of the window.
Select Yes.
-
Run the app by entering the following command in the command shell:
dotnet run
Learn more
Explore all the features the C# extension has to offer by looking for .NET in the Command Palette. For more information on these features, refer to the other documentation pages.
For learning materials on C# and .NET, check out the following resources:
Join the community
Find community resources and connect with user groups.
.NET developer community - Meet with like-minded developers