C# 개발 환경 설정: Visual Studio 설치와 VS Code C# Dev Kit 사용법 | C# 강좌 2강
Visual Studio Community 설치와 VS Code의 C# Dev Kit 설정 방법을 단계별로 정리하고, 콘솔 프로젝트의 구조(.csproj, Program.cs, bin/obj)를 설명합니다. 빌드와 실행, Debug/Release 차이, 디버깅 실행과 자주 나오는 오류까지 다룹니다.
지난 강에서는 터미널에서 dotnet new console과 dotnet run으로 첫 프로그램을 실행했어요. 이번 강에서는 코드를 더 편하게 작성하고 오류를 빨리 찾을 수 있도록 Visual Studio와 VS Code + C# Dev Kit 개발 환경을 갖춥니다.
그다음 프로젝트 폴더 안의 파일들이 각각 어떤 역할을 하는지, 그리고 빌드와 실행이 정확히 무엇인지 정리해요. 앞으로 47강 동안 매번 쓰게 될 기본기예요.
어떤 도구를 골라야 할까요
C# 코드는 메모장으로도 작성할 수 있지만, 자동 완성·오류 표시·디버깅을 지원하는 도구를 쓰면 훨씬 편해요. 대표적인 선택지는 두 가지예요.
| 구분 | Visual Studio | VS Code + C# Dev Kit |
|---|---|---|
| 종류 | 통합 개발 환경(IDE) | 가벼운 코드 편집기 + 확장 |
| 운영체제 | Windows | Windows, macOS, Linux |
| 설치 용량 | 크다(수 GB 이상) | 작다 |
| 장점 | 설치만 하면 모든 기능이 준비됨 | 가볍고 여러 언어를 함께 쓰기 좋음 |
| 가격 | Community 에디션 무료(개인·학습용) | 편집기 무료, Dev Kit은 개인 사용 무료 |
Windows를 쓰고 C#만 집중해서 배우려면 Visual Studio가 편해요. macOS나 Linux를 쓰거나 가벼운 환경을 원하면 VS Code를 고르면 됩니다.
Visual Studio for Mac은 2024년에 지원이 종료되었어요. macOS 사용자는 VS Code(또는 JetBrains Rider 같은 다른 IDE)를 쓰세요.
Visual Studio 설치하기
Visual Studio는 Microsoft 공식 사이트(visualstudio.microsoft.com)에서 받을 수 있어요. 에디션은 Community, Professional, Enterprise가 있는데 학습용으로는 무료인 Community면 충분해요.
설치 순서
- 공식 사이트에서 최신 버전의 Community 설치 파일을 내려받아 실행해요.
- Visual Studio Installer가 열리면 '워크로드' 탭에서 .NET 데스크톱 개발을 체크해요.
- 오른쪽 아래 '설치' 버튼을 누르고 완료될 때까지 기다려요.
- 설치가 끝나면 Visual Studio를 실행하고 Microsoft 계정으로 로그인해요(건너뛰어도 사용 가능해요).
워크로드는 '용도별 기능 묶음'이에요. 콘솔 프로그램만 만든다면 .NET 데스크톱 개발 하나로 충분하고, 나중에 웹을 배울 때 ASP.NET 및 웹 개발을 추가로 설치하면 돼요.
Visual Studio를 설치하면 .NET SDK도 함께 설치되기 때문에, 1강에서 SDK를 따로 설치했더라도 문제없어요. 여러 버전의 SDK가 나란히 설치될 수 있어요.
첫 콘솔 프로젝트 만들기
- 시작 화면에서 새 프로젝트 만들기를 선택해요.
- 검색창에
콘솔을 입력하고 콘솔 앱(C# 표시가 있는 것)을 고른 뒤 '다음'을 눌러요. - 프로젝트 이름을
HelloApp으로 적고 저장 위치를 정해요. - 프레임워크는 최신 LTS 버전(이 강좌는 .NET 10 기준)을 고르고 '만들기'를 눌러요.
'최상위 문 사용 안 함' 옵션은 체크하지 마세요. 1강에서 배운 최상위 문(top-level statements) 방식으로 Program.cs가 만들어져요.
프로젝트가 열리면 Program.cs의 내용을 아래처럼 바꿔 보세요.
// 화면에 세 줄을 출력하는 프로그램
Console.WriteLine("Visual Studio에서 실행했어요!");
Console.WriteLine("빌드: 소스 코드 → 실행 파일");
Console.WriteLine("실행: 만들어진 프로그램을 동작");
Ctrl+F5(디버깅하지 않고 시작)를 누르면 콘솔 창이 뜨고 결과가 나와요.
Visual Studio에서 실행했어요!
빌드: 소스 코드 → 실행 파일
실행: 만들어진 프로그램을 동작
Console.WriteLine은 괄호 안의 문자열을 출력하고 줄을 바꿔요. 세 번 호출했으니 세 줄이 출력돼요.
화면 구성 살펴보기
| 창 이름 | 역할 |
|---|---|
| 솔루션 탐색기 | 솔루션과 프로젝트, 파일 목록을 트리로 보여 줘요 |
| 코드 편집기 | 가운데에서 코드를 작성해요 |
| 오류 목록 | 컴파일 오류와 경고를 모아 보여 줘요 |
| 출력 창 | 빌드 과정의 메시지를 보여 줘요 |
창이 안 보이면 상단 메뉴의 보기(View) 에서 다시 열 수 있어요.
VS Code와 C# Dev Kit 설정하기
VS Code(Visual Studio Code)는 이름은 비슷하지만 Visual Studio와는 다른 프로그램이에요. 기본은 가벼운 편집기이고, 확장(extension)을 설치해서 C# 개발 기능을 붙여요.
설치 순서
- code.visualstudio.com에서 VS Code를 내려받아 설치해요.
- 1강에서 설치한 .NET SDK가 있는지 터미널에서
dotnet --version으로 확인해요. - VS Code 왼쪽의 확장(Extensions) 아이콘(Ctrl+Shift+X)을 누르고
C# Dev Kit를 검색해 설치해요.
C# Dev Kit를 설치하면 필요한 확장이 함께 설치돼요.
| 확장 | 역할 |
|---|---|
| C# Dev Kit | 솔루션 탐색기, 프로젝트 관리, 테스트 기능 |
| C# | 자동 완성, 오류 표시, 디버깅의 핵심 엔진 |
| .NET Install Tool | 필요한 .NET 런타임을 관리 |
프로젝트 만들고 실행하기
VS Code에서는 두 가지 방법으로 프로젝트를 만들 수 있어요.
- 명령 팔레트 사용: Ctrl+Shift+P(macOS는 Cmd+Shift+P)를 누르고
.NET: New Project를 입력한 뒤 '콘솔 앱'을 골라요. - 터미널 사용: 1강처럼
dotnet new console -o HelloApp으로 만든 다음, VS Code에서 그 폴더를 열어요.
# 터미널에서 프로젝트를 만들고 VS Code로 열기
dotnet new console -o HelloApp
code HelloApp
폴더를 열면 탐색기 아래쪽에 SOLUTION EXPLORER 영역이 생겨요. Visual Studio의 솔루션 탐색기와 같은 역할이에요.
Program.cs를 열고 F5를 누르면 디버거를 연결해 실행하고, Ctrl+F5를 누르면 디버거 없이 실행해요. 처음 실행할 때 디버거 종류를 물어보면 C# 을 고르세요.
터미널을 더 좋아한다면 VS Code 안의 터미널(Ctrl+)에서dotnet run`을 입력해도 돼요. 결과는 같아요.
프로젝트 구조 이해하기
어떤 도구로 만들든 콘솔 프로젝트의 폴더 구조는 같아요.
HelloApp/
├── HelloApp.csproj ← 프로젝트 설정 파일
├── Program.cs ← 소스 코드
├── bin/ ← 빌드 결과물(실행 파일)
└── obj/ ← 빌드 중간 파일
Visual Studio로 만들면 상위 폴더에 솔루션 파일(.sln 또는 새 형식인 .slnx)이 하나 더 생겨요.
솔루션과 프로젝트
프로젝트는 실행 파일이나 라이브러리 하나를 만드는 단위예요. 솔루션은 여러 프로젝트를 묶어 관리하는 상자예요.
지금은 프로젝트 하나만 쓰니까 솔루션을 크게 신경 쓰지 않아도 돼요. 나중에 프로그램 본체와 테스트 프로젝트를 함께 관리할 때 솔루션이 쓸모 있어요.
.csproj 파일
HelloApp.csproj를 열어 보면 XML 형식의 설정이 들어 있어요.
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<OutputType>Exe</OutputType>
<TargetFramework>net10.0</TargetFramework>
<ImplicitUsings>enable</ImplicitUsings>
<Nullable>enable</Nullable>
</PropertyGroup>
</Project>
| 항목 | 의미 |
|---|---|
OutputType |
Exe는 실행 가능한 프로그램을 만든다는 뜻이에요 |
TargetFramework |
어떤 .NET 버전에서 동작할지 정해요 |
ImplicitUsings |
자주 쓰는 네임스페이스를 자동으로 포함해요. 덕분에 using System; 없이 Console을 쓸 수 있어요 |
Nullable |
null 관련 경고 기능을 켜요(나중에 배웁니다) |
.csproj에는 어떤 .cs 파일을 포함할지 적혀 있지 않아요. 프로젝트 폴더 안의 모든 .cs 파일이 자동으로 포함되기 때문이에요.
bin과 obj 폴더
obj는 빌드하는 중간에 쓰이는 임시 파일, bin은 최종 결과물이 저장되는 곳이에요. 둘 다 빌드하면 다시 만들어지므로 지워도 괜찮고, Git 같은 버전 관리에는 보통 올리지 않아요.
빌드와 실행
빌드(build) 는 사람이 쓴 C# 소스 코드를 컴퓨터가 실행할 수 있는 형태(.dll, 실행 파일)로 바꾸는 과정이에요. 실행(run) 은 그렇게 만들어진 결과물을 동작시키는 거예요.
명령어로 빌드하고 실행하기
# 프로젝트 폴더(.csproj가 있는 곳)에서 실행
dotnet build
Restore complete (0.6s)
HelloApp net10.0 succeeded (1.8s) → bin/Debug/net10.0/HelloApp.dll
Build succeeded in 2.9s
괄호 안의 시간은 컴퓨터마다 달라요. 화살표 뒤의 경로가 결과물이 만들어진 위치예요.
dotnet run은 필요하면 빌드까지 자동으로 하고 바로 실행해요. 그래서 평소에는 dotnet run 하나만 써도 충분해요.
| 명령어 | 하는 일 |
|---|---|
dotnet build |
빌드만 해요 |
dotnet run |
(필요하면) 빌드한 뒤 실행해요 |
dotnet watch |
파일을 저장할 때마다 자동으로 다시 실행해요 |
dotnet clean |
bin, obj의 빌드 결과물을 정리해요 |
Debug와 Release 구성
빌드에는 구성(configuration) 이 있어요. 기본값은 Debug이고, 배포할 때는 Release를 써요.
| 구성 | 특징 | 결과물 위치 |
|---|---|---|
| Debug | 디버깅 정보 포함, 최적화 적음 | bin/Debug/net10.0/ |
| Release | 최적화되어 더 빠름 | bin/Release/net10.0/ |
# Release 구성으로 빌드
dotnet build -c Release
Visual Studio에서는 상단 도구 모음의 'Debug' 드롭다운에서 'Release'로 바꿀 수 있어요.
F5와 Ctrl+F5의 차이
Visual Studio와 VS Code 모두 단축키가 같아요.
| 단축키 | 이름 | 용도 |
|---|---|---|
| F5 | 디버깅 시작 | 중단점에서 멈추고 코드를 한 줄씩 살펴볼 때 |
| Ctrl+F5 | 디버깅하지 않고 시작 | 결과만 빨리 확인할 때 |
| Ctrl+Shift+B | 빌드 | 실행 없이 오류만 확인할 때 |
중단점으로 한 줄씩 실행해 보기
디버깅은 프로그램을 원하는 위치에서 멈추고 살펴보는 기능이에요. 아래 코드로 연습해 보세요.
// 중단점 연습용 프로그램
Console.WriteLine("1단계: 프로그램 시작");
Console.WriteLine("2단계: 이 줄에 중단점을 걸어 보세요");
Console.WriteLine("3단계: 프로그램 끝");
두 번째 Console.WriteLine 줄 번호 왼쪽 여백을 클릭하면 빨간 점(중단점)이 생겨요. 이 상태에서 F5를 누르면 그 줄을 실행하기 직전에 멈춰요.
이때 콘솔에는 첫 줄만 출력되어 있어요. F10(프로시저 단위 실행)을 누를 때마다 한 줄씩 진행되고, F5를 다시 누르면 끝까지 실행돼요.
1단계: 프로그램 시작
2단계: 이 줄에 중단점을 걸어 보세요
3단계: 프로그램 끝
지금은 출력만 하는 코드라 별 차이가 없어 보이지만, 3강에서 변수를 배우면 멈춘 상태에서 변수 값을 직접 확인할 수 있어서 아주 유용해요.
자주 하는 실수와 오류 메시지
프로젝트 폴더가 아닌 곳에서 dotnet run
.csproj가 없는 폴더에서 dotnet run을 실행하면 아래 오류가 나요.
Couldn't find a project to run. Ensure a project exists in C:\Users\me\code, or pass the path to the project using --project.
cd HelloApp으로 프로젝트 폴더로 이동하거나, dotnet run --project HelloApp처럼 경로를 지정하면 해결돼요.
세미콜론 빠뜨리기
C# 문장은 세미콜론(;)으로 끝나야 해요. 아래 코드는 빌드되지 않아요.
Console.WriteLine("빌드 오류를 고쳤어요") // 세미콜론이 없어요
Console.WriteLine("이제 잘 실행돼요");
Program.cs(1,39): error CS1002: ; expected
한국어 환경에서는 error CS1002: ;이(가) 필요합니다.처럼 보여요. (1,39)는 1번째 줄 39번째 글자라는 뜻이니 그 위치를 확인하세요.
편집기는 이런 오류를 빨간 물결 밑줄로 미리 알려 줘요.
빌드 오류가 있으면 실행 파일이 새로 만들어지지 않아요. Visual Studio가 '빌드 오류가 발생했습니다.
마지막으로 성공한 빌드를 실행하시겠습니까?'라고 물으면 '아니요'를 고르고 오류부터 고치세요.
그 밖에 주의할 점
- VS Code에서 파일 하나만 열기:
Program.cs파일만 열면 C# Dev Kit가 프로젝트를 인식하지 못해 자동 완성이 안 돼요. 꼭 폴더를 여세요. - 한 폴더에 프로젝트 여러 개 만들기: 같은 폴더에
.csproj가 두 개 있으면dotnet run이 어느 것을 실행할지 몰라 오류가 나요. 프로젝트마다 폴더를 따로 만드세요. - SDK를 못 찾음: VS Code에서 '.NET SDK를 찾을 수 없다'는 메시지가 나오면 터미널에서
dotnet --version을 확인하고, SDK 설치 후 VS Code를 다시 시작하세요.
연습 문제
MyProfile이라는 콘솔 프로젝트를 만들고, 이름·사용 도구·목표를 한 줄씩 출력하는 프로그램을 작성해 실행하세요.- 1번 프로젝트를 Release 구성으로 빌드하고 실행하는 명령어를 쓰세요. 결과물(.dll)이 생기는 폴더 경로도 적어 보세요.
- 아래 코드는 빌드되지 않아요. 오류 번호를 말하고, 고친 코드를 작성하세요.
Console.WriteLine("빌드 오류를 고쳤어요")
Console.WriteLine("이제 잘 실행돼요");
정답 예시
1번
dotnet new console -o MyProfile
cd MyProfile
// MyProfile/Program.cs
Console.WriteLine("이름: 김코딩");
Console.WriteLine("사용 도구: VS Code + C# Dev Kit");
Console.WriteLine("목표: C# 콘솔 프로그램 완성");
이름: 김코딩
사용 도구: VS Code + C# Dev Kit
목표: C# 콘솔 프로그램 완성
Visual Studio를 쓴다면 '새 프로젝트 만들기 → 콘솔 앱'에서 이름을 MyProfile로 정하면 돼요.
2번
# Release로 빌드만 하기
dotnet build -c Release
# Release로 빌드하고 실행하기
dotnet run -c Release
결과물은 bin/Release/net10.0/MyProfile.dll에 생겨요. Windows에서는 같은 폴더에 MyProfile.exe도 함께 만들어져요.
3번
오류 번호는 CS1002(세미콜론이 필요함)예요. 첫 줄 끝에 세미콜론을 붙이면 돼요.
Console.WriteLine("빌드 오류를 고쳤어요");
Console.WriteLine("이제 잘 실행돼요");
빌드 오류를 고쳤어요
이제 잘 실행돼요
핵심 정리
- Windows에서는 Visual Studio Community(워크로드: .NET 데스크톱 개발), 모든 운영체제에서는 VS Code + C# Dev Kit를 쓸 수 있어요.
- C# Dev Kit를 설치하면 C# 확장과 .NET Install Tool이 함께 설치되고, VS Code에서 솔루션 탐색기와 디버깅을 쓸 수 있어요.
- 프로젝트는
.csproj(설정),Program.cs(소스),bin(결과물),obj(중간 파일)로 구성되고, 솔루션은 여러 프로젝트를 묶는 단위예요. - 빌드는 소스 코드를 실행 가능한 결과물로 바꾸는 것이고,
dotnet run은 필요하면 빌드한 뒤 실행해요. - 기본 구성은 Debug(
bin/Debug)이고, 배포용은-c Release로 빌드해요. - F5는 디버깅 실행, Ctrl+F5는 디버깅 없는 실행, 중단점과 F10으로 한 줄씩 살펴볼 수 있어요.
- 오류 메시지의
(줄,칸)과CS번호를 보면 원인을 빨리 찾을 수 있어요.
강좌 이어 보기
- 이전 강좌: 1강 C#이란? .NET 설치와 첫 프로그램
- 다음 강좌: 3강 변수와 자료형 (곧 올라옵니다)
- C# 강좌 전체 목차 보기