[C++] VSCode를 이용한 C++ 개발 환경 세팅 가이드

이 글은 윈도우 환경에서 Visual Studio Code를 이용한 C++ 개발 환경을 세팅하는 방법에 대해 정리한 글이다.

---

서론

왜 VSCode를 사용하는가?

• 오픈 소스
• 가볍고 빠른 속도
• 다양한 확장 기능
• 무료

이 외에도 다양한 이유가 존재할 수 있지만, 필자가 생각하기에 가볍고 빠른 속도가 가장 큰 장점인 것 같다. Visual Studio도 사용하기도 하지만, 알고리즘 학습과 같은 학습 과정에서는 VSCode 만큼 괜찮은 프로그램은 아직 찾지 못한 것 같다.

시스템 환경

현재 필자가 개발 환경을 세팅하는 시점에서, 필자의 노트북에는 Windows 11 Home 24H2 버전이 설치되어 있다.

• 에디션 : Windows 11 Home
• 버전 : 24H2

---

설치 방법

1. 컴파일러 설치 (MinGW)

MinGW-w64 다운로드 및 설치

먼저 컴파일러를 설치해야 한다. 본 글에서 사용할 컴파일러는 MinGW(Minimalist GNU for Windows)이다. MinGW는 윈도우 환경에서 gcc/g++ 기반의 C++ 개발을 가능하게 해주는 핵심 툴체인이다.

MinGW (Minimalist GNU for Windows)
리눅스 및 유닉스 계열에서 주로 사용하던 gcc, g++, gdb 등의 툴 체인을 윈도우 환경에서 사용할 수 있도록 포팅하여 제공하는 프로젝트로, 윈도우에서 C 및 C++을 기반으로 개발하는데 필요한 컴파일러(gcc, g++), 링커(Id), 디버거(gdb), 그리고 기본 라이브러리를 포함하고 있다.

OS 종류에 따라 다양한 버전이 존재하지만, 본 글에서는 VSCode에서 공식적으로 설명하고 있는 MSYS2를 설치할 것이다. 아래 링크를 통해 이동해서 MSYS2 설치파일을 다운 받아준다.

https://www.msys2.org/

MSYS2

설치파일은 아래 표시된 부분의 버튼을 클릭하면 다운 받을 수 있다.

설치 파일을 받았다면, 설치를 진행한다. 따로 변경하거나 체크할 부분 없이 설치를 쭉 진행하면 된다.

설치가 완료되었다면, Run MSYS2 now를 체크한 후 설치를 종료한다. 그럼 아래와 같이 MSYS2 터미널이 실행된다.

만약 체크를 해제하고 설치를 종료하여 터미널이 실행되지 않는다면, 설치된 프로그램들 중에서 MSYS2 UCRT64를 실행하면 된다.

터미널이 실행되면, 아래 명령어를 입력해 MinGW-w64 toolchain을 설치한다.

pacman -S --needed base-devel mingw-w64-ucrt-x86_64-toolchain

명령어를 실행하면 아래와 같이 선택하는 내용이 뜨는데, 아무 입력 없이 Enter를 눌러 모두 설치를 진행한다.

그럼 약 1GiB에 해당하는 파일이 설치된다. 설치가 다 끝날 때까지 기다리면 된다.

설치가 완료되었으면, 다음 단계로 넘어가자.

설치 경로 지정

다음은 MinGW의 bin 폴더를 윈도우 환경 변수에 경로를 추가해야 한다. 시스템 속성 > 환경 변수 > 사용자 변수 > Path에 아래 경로를 추가하면 된다.

(만약 설치 과정에서 MSYS2의 설치 위치를 변경하였다면, 변경한 설치 위치 아래 ucrt64 > bin 폴더의 경로를 복사해서 추가하면 된다.)

C:\msys64\ucrt64\bin

 

환경 변수로 경로 추가를 완료하였다면, 터미널을 열고 아래 명령어를 실행해 정상적으로 실행되는지 확인한다. 아래 이미지와 같이 해당 컴파일러 및 디버거의 버전이 뜨면 정상적으로 설치가 완료된 것이다.

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

2. VSCode 설치

VSCode 다운로드 및 설치

VSCode는 VSCode 공식 홈페이지에서 다운 받은 후 설치한다. 설치 파일은 아래 링크(공식 홈페이지)에서 받을 수 있다.

https://code.visualstudio.com/

Visual Studio Code - Code Editing. Redefined

(설치 과정은 그냥 설치를 진행하면 되기 떄문에 생략한다.)

설치가 완료되면, 실행해서 간단한 초기 설정(언어, 인터페이스 테마 등)을 진행한다.

확장 프로그램 설치

간단한 쵝 설정을 완료하였다면, C/C++ 개발을 도와줄 필수 확장 프로그램을 설치해야 한다.

VSCode를 실행한 후 Extension 탭에서 C/C++ 확장 프로그램을 설치한다. Extension 탭에서 검색 또는 아래 링크를 통해 설치를 진행할 수 있다.

https://marketplace.visualstudio.com/items?itemName=ms-vscode.cpptools

C/C++ - Visual Studio Marketplace

3. 프로젝트 생성 및 테스트

예시 프로젝트 폴더를 하나 생성한 후, VSCode에서 해당 폴더를 열어준다. 그리고 간단하게 .cpp 확장자로 파일을 하나 만들고 간단한 예제 코드를 작성한다.

#include <iostream>
using namespace std;

int main() {
    cout << "Hello, World!" << endl;
    return 0;
}

그리고 컴파일을 진행한다. 컴파일은 VSCode 내장 터미널 (ctrl + `) 혹은 외부 터미널에서 아래 명령어를 실행한 후 Hello World!가 실행되는지 확인한다.

g++ main.cpp -o main
./main.exe

프로젝트 경로에 .exe 파일이 생성되고, 터미널에 Hello World!가 출력되면 정상적으로 설치가 완료된 것이다.

매번 명령어를 입력하는 것이 귀찮다면, Run Code Extension을 설치하면 VSCode의 우측 상단에 실행 버튼이 추가된다.

https://marketplace.visualstudio.com/items?itemName=formulahendry.code-runner

Code Runner - Visual Studio Marketplace

---

참고 자료

https://code.visualstudio.com/docs/cpp/config-mingw

Get Started with C++ and MinGW-w64 in Visual Studio Code