.NET SDK Setup, VS Code, CLI & Project Structure Masterclass
Welcome to Phase 1 (Chapter 2): .NET SDK Setup, IDEs, .NET CLI & Project Structure Masterclass! To compile and run C# applications, you need the .NET SDK (Software Development Kit). In this lesson, we explore the difference between the SDK and Runtime, setup Visual Studio 2022 and VS Code with C# Dev Kit, master command-line development using the dotnet CLI, dissect .NET project files (.csproj), and resolve common environment setup errors.
Before installing tools, it is vital to understand the difference between the .NET SDK and the .NET Runtime:
| Component | What it Includes | Target Audience | Primary Use Case |
|---|---|---|---|
| .NET Runtime | CLR Execution Engine + Core Class Libraries | End users & Production servers | Executing already compiled .NET applications (.dll / .exe) |
| .NET SDK | .NET Runtime + C# Compiler (csc) + MSBuild + dotnet CLI + Project Templates | Software Developers | Creating, editing, building, debugging, and publishing C# projects |
You can write C# in a variety of environments depending on your Operating System and project scope:
Development Environments Compared:
• Visual Studio Code (Cross-Platform): Lightweight, fast code editor. Install the official C# Dev Kit extension pack from Microsoft for full Roslyn IntelliSense, project solution explorer, and debugging.
• Visual Studio 2022 (Windows / macOS): Enterprise-grade IDE featuring GUI layout designers, memory profilers, remote debugging, and database tools.
• Online C# Compiler: Run C# code snippets instantly in your web browser without installing anything on mana-compiler C# IDE.
The dotnet command-line interface (CLI) is the universal tool for creating, restoring, building, and running .NET projects across Windows, Linux, and macOS.
# 1. Create a new C# Console application project named HelloCSharp
dotnet new console -n HelloCSharp
# 2. Navigate into the project folder
cd HelloCSharp
# 3. Build and Run the project immediately
dotnet run
# 4. Compile/Build project without executing
dotnet build
# 5. Clean build output directories (bin/ and obj/)
dotnet clean
# 6. Publish optimized production release binaries
dotnet publish -c ReleaseWhen you create a console application, the .NET CLI generates a clean project layout:
The .csproj file contains project metadata and settings written in XML:
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<OutputType>Exe</OutputType>
<TargetFramework>net8.0</TargetFramework>
<ImplicitUsings>enable</ImplicitUsings>
<Nullable>enable</Nullable>
</PropertyGroup>
</Project>| XML Element | Explanation & Function |
|---|---|
Sdk="Microsoft.NET.Sdk" | Imports standard .NET build rules and Roslyn compilation targets. |
<OutputType>Exe</OutputType> | Specifies that compilation produces an executable application (vs Class Library .dll). |
<TargetFramework>net8.0</TargetFramework> | Targets the .NET 8.0 runtime environment. |
<ImplicitUsings>enable</ImplicitUsings> | Automatically includes standard namespaces like System, System.Linq, System.IO across all files. |
<Nullable>enable</Nullable> | Enables C# Nullable Reference Types compiler checks to eliminate null reference exceptions. |
This error occurs when the .NET SDK is not installed or its installation directory is missing from your system PATH environment variable. Download the latest SDK installer from dotnet.microsoft.com and restart your terminal session.
This happens if your project targets .NET 8.0, but your machine only has an older SDK installed (e.g., .NET 6 or 7). Run dotnet --version to verify your installed SDK, and update it accordingly.
Q1: How do I view all installed .NET SDKs and runtimes on my computer?
Run dotnet --list-sdks to list SDKs, and dotnet --list-runtimes to list installed runtimes.
Q2: What is NuGet?
NuGet is the official .NET package manager. You can add open-source libraries to your project using dotnet add package PackageName.
Q3: What is a .sln Solution file?
A Solution file (.sln) is a container that groups multiple related .csproj projects (e.g., Web API + Data Access Library + Unit Tests) in a single workspace.