개발 환경 설정
.NET SDK 와 편집기를 갖추고 dotnet 명령으로 첫 프로젝트를 만듭니다.
무엇을 갖추어야 C#을 사용할 수 있나
C# 코드를 작성하고 실행하는 데 필요한 것은 .NET SDK 하나입니다. 이 안에
코드를 실행 파일로 바꾸는 컴파일러, 프로젝트를 다루는
dotnet 명령, 그리고 만든 프로그램을 실제로 돌리는 런타임이
모두 들어 있습니다.
내려받는 자리에 SDK와 런타임이 나란히 있는데, 둘은 용도가 다릅니다.
- SDK — 프로그램을 만드는 데 필요합니다. 컴파일러가 들어 있어 소스 코드를 실행할 수 있는 형태로 바꿉니다.
- 런타임(Runtime) — 이미 만들어진 프로그램을 돌리기만 할 때 필요합니다. 컴파일러가 없으므로 이것만 설치해서는 코드를 작성해 빌드할 수 없습니다.
배우는 동안에는 SDK만 받으면 됩니다. 런타임은 SDK 안에 함께 들어 있어서 따로 받을 필요가 없습니다. 런타임을 따로 받는 쪽은 남이 만든 프로그램을 돌리기만 하는 서버 같은 자리입니다.
첫 프로젝트 만들고 돌리기
SDK를 설치했다면 터미널에서 아래 세 줄로 프로그램 하나를 만들어 돌려볼 수 있습니다. 첫 줄이 HelloApp 폴더를 만들면서 그 안에 필요한 파일을 갖춰 놓고, 마지막 줄이 빌드와 실행을 한 번에 합니다.
dotnet new console -o HelloApp cd HelloApp dotnet run
이 단원의 명령은 브라우저가 아니라 여러분의 터미널에서 돌립니다.
설치가 제대로 됐는지 먼저 확인하고 싶다면 아래 명령이 버전을 알려 줍니다. 숫자가 나오지 않고 명령을 찾을 수 없다는 말이 나오면 설치가 끝나지 않았거나 터미널을 다시 열어야 하는 경우입니다.
dotnet --version # 설치된 SDK 버전 dotnet --list-sdks # 설치된 SDK 를 모두 보여 줍니다 dotnet --list-runtimes # 설치된 런타임을 모두 보여 줍니다
편집기와 자주 사용하는 명령
편집기는 취향과 환경에 따라 선택하면 됩니다. 어느 것을 사용하든 코드와 SDK는 그대로이므로, 나중에 갈아타도 배운 것이 사라지지 않습니다.
- Visual Studio — 윈도우에서 가장 손이 덜 가는 선택입니다. 디버깅과 프로젝트 관리 도구가 처음부터 갖춰져 있습니다.
- Visual Studio Code — 가볍고 윈도우·맥·리눅스에서 모두 돌아갑니다. C# 확장(C# Dev Kit)을 설치해야 자동 완성과 디버깅이 붙습니다.
- JetBrains Rider — 리팩터링 도구가 강한 유료 편집기입니다.
편집기가 무엇이든 아래 명령들은 그대로 사용할 수 있습니다. 편집기의 실행 단추도 결국 이 명령을 대신 눌러 주는 것입니다.
| 명령 | 하는 일 | 예시 |
|---|---|---|
| dotnet new | 새 프로젝트를 만듭니다 | dotnet new console -o MyApp |
| dotnet run | 빌드하고 곧바로 실행합니다 | dotnet run |
| dotnet build | 빌드만 합니다 | dotnet build |
| dotnet add package | 남이 만든 라이브러리를 더합니다 | dotnet add package Newtonsoft.Json |
| dotnet --version | SDK 버전을 알려 줍니다 | dotnet --version |
만들어진 폴더 안에는 무엇이 있나
dotnet new console 이 만든 폴더를 열어 보면 파일이 둘뿐입니다.
나머지는 빌드할 때 생기는 것이라 직접 손댈 일이 없습니다.
HelloApp/ ├─ HelloApp.csproj // 프로젝트 설정 — 어느 .NET 을 사용할지 등 ├─ Program.cs // 실제 코드가 들어가는 자리 ├─ bin/ // 빌드 결과물 (자동 생성) └─ obj/ // 빌드 중간 파일 (자동 생성)
.csproj 를 열면 아래처럼 짧은 설정이 들어 있습니다.
TargetFramework 가 이 프로젝트를 어느 .NET 위에서 돌릴지
정하는 자리입니다.
<Project Sdk="Microsoft.NET.Sdk"> <PropertyGroup> <OutputType>Exe</OutputType> <TargetFramework>net10.0</TargetFramework> </PropertyGroup> </Project>
어느 .NET을 선택해야 하나
- 8LTS · 2023.11
- 10LTS · 2025.11 — 지금 시작한다면 이 버전
.NET은 해마다 11월에 새 버전이 나오고, 짝수 버전이 LTS(장기 지원)로 3년 동안 고쳐집니다. 홀수 버전은 STS로 18개월입니다. 배우는 동안에는 LTS를 선택하면 한동안 버전을 신경 쓰지 않아도 됩니다. 이 사이트의 예제는 .NET 10과 그에 딸린 C# 14를 기준으로 작성합니다.
직접 해보기
터미널을 열어 설치된 SDK의 버전을 확인하고, 여러 버전이 깔려 있다면 그 목록도 함께 확인해보세요.
콘솔 프로젝트를 하나 만들고, Program.cs 의 출력 문구를 자기 이름이 들어가게 고친 뒤 다시 실행해보세요.
- 코드를 만들려면 SDK가 필요합니다. 런타임만으로는 빌드할 수 없습니다.
dotnet new console로 만들고dotnet run으로 돌립니다.- 프로젝트에서 손댈 파일은 Program.cs 와 .csproj 둘뿐이고, bin·obj 는 빌드가 알아서 만듭니다.
- 버전은 짝수 LTS를 선택하면 3년 동안 지원을 받습니다.
C# 버전별 변경 이력 에서 각 버전이 무엇을 더했는지 볼 수 있습니다.