2. 개발 환경 준비: 컴파일러, IDE, 첫 실행

C++를 배우겠다고 마음먹은 순간, 가장 먼저 넘어야 하는 산은 문법이 아니라 환경 설정이다. 코드는 손으로 쓰는 것만으로는 움직이지 않는다. C++는 컴파일 언어이기 때문에, 내가 쓴 소스 코드를 컴퓨터가 실행할 수 있는 형태로 바꿔 주는 과정이 꼭 필요하다.¹

이 장의 목표는 단순하다. 코드를 작성하고, 컴파일하고, 실행하는 흐름을 몸으로 익히는 것이다. 아직 완벽한 설정을 만들 필요는 없다. 오늘은 "내 컴퓨터에서 C++ 코드가 실제로 돌아간다!"까지 가면 성공이다.

개발 환경이 왜 필요한가

C++ 학습은 자전거 배우기와 비슷하다. 균형 잡는 법을 글로 읽는 것만으로는 앞으로 나아갈 수 없다. 직접 페달을 밟아 봐야 한다. 개발 환경도 마찬가지다. 설치가 끝나야 변수도, 조건문도, 함수도 비로소 살아 움직인다.

개발 환경에는 보통 세 가지가 들어 있다.

• 컴파일러: C++ 코드를 실행 파일로 바꿔 주는 도구

• 에디터 또는 IDE: 코드를 쓰고 관리하는 도구

• 터미널/디버거: 프로그램을 실행하고 문제를 찾는 도구

여기서 가장 중요한 건 컴파일러다. VS Code 같은 에디터는 코드를 예쁘게 보여 주고 자동 완성도 해 주지만, 컴파일러 자체를 포함하지는 않는다. 그래서 VS Code를 설치했다고 바로 C++가 실행되지는 않는다.¹

무엇을 설치하면 좋을까

초보자에게 추천하는 선택지는 크게 두 가지다.

선택지 1: VS Code + 컴파일러

이 조합은 가볍고, Windows·macOS·Linux에서 거의 비슷한 방식으로 쓸 수 있다. VS Code에 Microsoft의 C/C++ 확장을 설치하면 문법 강조, 자동 완성(IntelliSense), 오류 표시 같은 기능을 사용할 수 있다.¹

이 방식은 "코드 작성 → 터미널에서 컴파일 → 실행" 흐름을 잘 보여 준다는 장점이 있다. 즉, 프로그래밍이 실제로 어떻게 돌아가는지 배우기에 좋다.

선택지 2: Visual Studio

Windows 사용자라면 Visual Studio Community도 매우 좋은 선택이다. 설치할 때 "C++을 사용한 데스크톱 개발" 워크로드를 고르면 MSVC 컴파일러와 필요한 도구들이 함께 설치된다.³⁴

처음에는 Visual Studio가 조금 무거워 보일 수 있지만, 실행과 디버깅이 편해서 "설정보다 코딩부터 해 보고 싶다"는 사람에게 잘 맞는다.

이 책에서는 원리 이해를 위해 VS Code + 컴파일러 조합을 기본 경로로 설명하되, Windows에서는 Visual Studio를 대안으로 함께 소개하겠다.

가장 먼저 할 일: 내 컴퓨터에 컴파일러가 있는지 확인하기

설치부터 시작하기 전에, 이미 컴파일러가 들어 있는지 확인해 보자. 어떤 시스템은 기본으로 제공한다.

VS Code 또는 터미널을 열고 아래 명령 중 하나를 입력한다.

g++ --version

또는

clang --version

버전 정보가 보이면 이미 컴파일러가 있는 것이다. 아무것도 나오지 않거나 "명령을 찾을 수 없음" 같은 메시지가 뜨면 설치가 필요하다.¹

이 확인 과정은 아주 중요하다. 초보자가 가장 많이 겪는 혼란 중 하나가 "VS Code는 깔았는데 왜 실행이 안 되지?"인데, 원인의 절반은 컴파일러가 없는 경우다.

운영체제별 설치 가이드

Windows: VS Code + MinGW-w64 또는 Visual Studio

Windows는 기본적으로 C++ 컴파일러가 없는 경우가 많다. 그래서 보통 MinGW-w64 또는 MSVC를 설치한다.²⁴

방법 A: VS Code + MinGW-w64

이 방법은 가볍고, 명령어 기반 학습에 좋다.

먼저 VS Code를 설치한다. 설치 중에 PATH에 추가 관련 옵션이 보이면 체크해 두는 편이 편하다. 그러면 터미널에서 code . 같은 명령을 쓸 수 있다.²

그다음 C/C++ 컴파일러를 설치한다. 공식 VS Code 문서에서는 Windows에서 MSYS2를 통해 MinGW-w64 도구 모음을 설치하는 예를 소개한다. 설치 후에는 MinGW-w64의 bin 폴더 경로를 Windows의 PATH 환경 변수에 추가해야 한다.¹

대표적인 경로 예시는 다음과 같다.

C:msys64ucrt64bin

설치가 끝났다면 새 명령 프롬프트를 열고 아래 명령으로 확인한다.

gcc --version
g++ --version
gdb --version

버전이 보이면 준비 완료다.¹

방법 B: Visual Studio Community

Windows에서는 이 방법이 가장 덜 헷갈릴 수 있다. Visual Studio 설치 프로그램을 실행한 뒤 "C++을 사용한 데스크톱 개발"을 선택하면 MSVC 컴파일러, Windows SDK, CMake 도구 등 필요한 요소를 함께 설치할 수 있다.⁴

설치 후에는 새 콘솔 프로젝트를 만들고 Ctrl + F5로 바로 실행할 수 있다.⁴

정리하면, 가볍게 배우려면 VS Code + MinGW-w64, 설정 스트레스를 줄이고 싶다면 Visual Studio라고 생각하면 된다.

macOS: Xcode Command Line Tools

macOS에서는 보통 Xcode Command Line Tools를 설치하면 Clang 계열 컴파일러를 사용할 수 있다. 설치 명령은 다음과 같다.⁵

xcode-select --install

설치가 끝나면 아래 명령으로 확인한다.

clang --version

또는

g++ --version

macOS에서 g++를 입력했는데 내부적으로 Clang이 동작하는 경우도 있다. 초보자 입장에서는 지금 단계에서 크게 걱정할 필요 없다. 중요한 건 C++ 파일을 컴파일해서 실행할 수 있느냐다.

Linux: GCC 설치

Linux는 배포판에 따라 다르지만, GCC가 이미 들어 있는 경우가 많다. 없으면 설치하면 된다.¹²

Ubuntu 또는 Debian 계열에서는 다음 명령이 가장 흔하다.

sudo apt install build-essential

Fedora 계열에서는 다음처럼 설치할 수 있다.

sudo dnf install gcc-c++ make

Arch Linux 계열에서는 다음과 같다.

sudo pacman -S gcc make

설치 후에는 아래처럼 확인한다.

g++ --version

버전이 보이면 잘 설치된 것이다.²

VS Code 설치와 확장 프로그램 추가

컴파일러가 준비되었다면 이제 코드를 편하게 쓸 작업 공간을 만들 차례다.

VS Code를 열고 왼쪽 확장 메뉴에서 C/C++ by Microsoft를 설치한다. 이 확장은 .cpp 파일을 열었을 때 문법 강조, 자동 완성, 마우스를 올렸을 때 설명 보기, 오류 검사 같은 기능을 제공한다.¹

중요한 점을 다시 한 번 강조하자. 이 확장은 똑똑한 필기구이지, 엔진은 아니다. 엔진은 컴파일러가 맡는다.

작업 폴더 만들기

처음부터 파일이 여기저기 흩어지면 금방 어질러진다. 작은 습관이 큰 차이를 만든다. 프로젝트용 폴더를 하나 만들자.

예를 들어 터미널에서 이렇게 시작할 수 있다.

mkdir projects
cd projects
mkdir helloworld
cd helloworld

그다음 이 폴더를 VS Code로 연다.

code .

이때 현재 폴더가 VS Code의 작업 폴더(workspace)가 된다.¹

초보자에게 권하고 싶은 습관이 하나 있다. 작은 실습 하나당 폴더 하나를 쓰는 것이다. 그래야 파일이 섞이지 않고, 나중에 다시 열어도 덜 헷갈린다.⁶

첫 번째 파일 만들기

이제 hello.cpp 파일을 만든다. 파일 이름의 .cpp는 "이건 C++ 소스 파일입니다"라는 표지판 같은 것이다.

파일에 다음 내용을 입력하고 저장하자.

#include <iostream>

int main()
{
    std::cout << "Hello World" << std::endl;
    return 0;
}

지금은 이 코드의 문법을 전부 이해하지 않아도 괜찮다. 이 장의 핵심은 환경이 제대로 동작하는지 확인하는 것이다. 문법 설명은 다음 장에서 차근차근 다룬다.

다만 아주 짧게만 말하면, 이 프로그램은 화면에 Hello World를 출력하고 정상적으로 끝난다.⁷

실행 방법 1: VS Code에서 바로 실행하기

VS Code에서 hello.cpp를 연 상태로 오른쪽 위의 실행 버튼을 누르면, 처음에는 어떤 컴파일러를 쓸지 고르라는 화면이 나올 수 있다. 여기서 시스템이 찾은 g++ 또는 관련 항목을 선택하면 된다. 빌드가 성공하면 통합 터미널에 Hello World가 출력된다.¹

이 방식의 장점은 간단하다는 것이다. 버튼 몇 번으로 "작성 → 빌드 → 실행" 흐름을 볼 수 있다.

실행 방법 2: 터미널에서 직접 컴파일하고 실행하기

나는 이 방법을 특히 추천한다. 이유는 간단하다. 프로그래밍의 실제 흐름이 눈에 잘 보이기 때문이다.

터미널에서 아래 명령을 입력한다.

g++ hello.cpp -o hello

이 명령은 hello.cpp를 컴파일해서 hello라는 실행 파일을 만든다.⁸

이제 실행한다.

macOS와 Linux에서는 보통 이렇게 입력한다.

./hello

Windows에서는 보통 이렇게 실행한다.

hello

화면에 Hello World가 보이면 성공이다.⁸

여기서 아주 중요한 흐름을 정리해 보자.

• 작성: hello.cpp 파일에 코드를 쓴다.

• 컴파일: g++ hello.cpp -o hello로 실행 파일을 만든다.

• 실행: 만들어진 파일을 실행한다.

이 세 단계가 C++ 학습의 기본 박자다. 앞으로 어떤 프로그램을 만들더라도 이 리듬은 계속 반복된다.

초보자가 꼭 알아야 할 말: 빌드, 컴파일, 실행

처음에는 용어가 비슷해서 헷갈린다. 아주 느슨하게 이해하면 이렇게 생각해도 좋다.

컴파일은 소스 코드를 기계가 이해할 수 있는 형태로 바꾸는 과정이다. 빌드는 보통 컴파일을 포함해 실행 파일을 만드는 전체 과정을 가리킨다. 실행은 그렇게 만들어진 프로그램을 실제로 돌리는 것이다.¹⁷

지금 단계에서는 "컴파일해서 실행 파일을 만들고, 그걸 실행한다" 정도로 이해하면 충분하다.

VS Code의 빌드 단축키와 설정 파일

VS Code는 단순한 텍스트 편집기 같아 보여도, 빌드와 디버깅을 위한 설정 파일을 사용할 수 있다. 대표적으로 tasks.json은 빌드 작업, launch.json은 디버깅 실행 방식을 담는다.⁹

하지만 초보자라면 처음부터 설정 파일을 손으로 만지작거릴 필요는 없다. 우선은 다음 순서가 훨씬 낫다.

1. 컴파일러 설치 확인

2. hello.cpp 작성

3. 터미널에서 직접 컴파일

4. VS Code 실행 버튼도 사용해 보기

이렇게 한 바퀴 돌고 나면, 나중에 설정 파일을 봐도 훨씬 덜 무섭다.

자주 만나는 문제와 해결법

환경 설정은 늘 약간의 말썽을 부린다. 하지만 대부분은 패턴이 비슷하다.

g++를 찾을 수 없다고 나올 때

가장 흔한 문제다. 컴파일러가 설치되지 않았거나, 설치는 되었는데 PATH에 잡히지 않은 경우다. Windows에서는 MinGW-w64의 bin 경로가 PATH에 들어갔는지 확인하자.¹²

파일은 있는데 실행이 안 될 때

컴파일이 실패했을 가능성이 있다. 먼저 컴파일 명령을 다시 실행해 보고, 오류 메시지를 읽어 보자. 실행 파일이 만들어지지 않았다면 당연히 실행도 안 된다.

콘솔 창이 너무 빨리 닫힐 때

특히 Windows의 일부 환경에서는 실행 결과가 잠깐 보였다가 창이 닫힐 수 있다. 이럴 때는 VS Code의 통합 터미널에서 실행하거나, Visual Studio에서는 Ctrl + F5로 "디버깅 없이 시작"을 사용하면 편하다.⁴

파일 확장자를 잘못 저장했을 때

hello.cpp가 아니라 hello.cpp.txt처럼 저장되어 있으면 컴파일러가 제대로 인식하지 못할 수 있다. 파일 확장자를 꼭 확인하자.

오늘 꼭 손에 넣어야 하는 감각

이 장에서 정말 가져가야 할 것은 화려한 설치 팁이 아니다. 다음 감각이다.

내가 쓴 코드는 그냥 글자가 아니다. 컴파일러를 거쳐 실행 파일이 되고, 그 실행 파일이 실제로 동작한다.

이 감각이 잡히면, 다음 장부터 배우는 문법이 훨씬 덜 추상적으로 느껴진다. if도, for도, 함수도 결국은 이 환경 안에서 살아 움직일 것이기 때문이다.

아직 설치가 잘 안 된다면

너무 오래 씨름하지는 말자. 환경 설정은 프로그래밍 실력의 시험이 아니다. 특히 초보자에게는 더 그렇다.

임시로는 온라인 컴파일러를 사용해 코드를 실행해 볼 수도 있다. 로컬 환경이 준비되기 전까지 문법 감각을 익히는 데 도움이 된다.¹⁰¹¹

하지만 가능하면 곧 로컬 환경으로 돌아오자. 앞으로 파일 관리, 디버깅, 여러 소스 파일 다루기까지 배우려면 내 컴퓨터의 개발 환경이 꼭 필요하다.

정리

이번 장에서 우리는 C++ 학습의 출발선을 만들었다. 컴파일러와 에디터의 차이를 이해했고, 운영체제에 맞는 설치 방법을 살펴봤으며, hello.cpp를 작성해 컴파일하고 실행하는 흐름까지 익혔다.

이제 여러분은 더 이상 "C++를 공부할 준비를 하는 사람"이 아니다. 이미 C++ 프로그램을 실행해 본 사람이다. 이 차이는 꽤 크다. 아주 작은 Hello World 한 줄이지만, 그 한 줄은 앞으로 배울 모든 문법의 출발점이 된다.

다음 장에서는 이 첫 프로그램을 바탕으로, C++ 프로그램이 어떤 모양으로 이루어져 있는지와 기본 문법의 감각을 본격적으로 살펴보자.

참고

¹C/C++ for Visual Studio Code

²C++ 개발 환경 설정 가이드

³C 및 C++ 애플리케이션 개발

⁴Visual Studio로 C/C++ 설치 및 설정하는 법 (완벽 가이드)

⁵Setting up a C++ Programming Environment

⁶0.7 — Compiling your first program

⁷C++ First Program

⁸Writing and Running Your First C++ Program

⁹윈도우에서 VS Code로 C/C++ 개발 환경 설정하기 (2025년 최신 가이드)

¹⁰Setting up C++ Development Environment

¹¹Online C++ Compiler - Programiz