Visual Studio Code 및 Git 설치
Visual Studio Code (VS Code)는 마이크로소프트가 개발한 무료 오픈소스 코드 편집기로, 다양한 운영체제를 지원하며 현대적인 웹 및 클라우드 애플리케이션 개발에 최적화된 환경을 제공합니다. Git은 Linus Torvalds가 개발한 분산 버전 관리 시스템으로, 프로젝트의 효율적인 관리를 돕습니다.
1. VS Code 및 Git 설치 파일 다운로드
- VS Code 공식 다운로드: https://code.visualstudio.com/
- Git 공식 다운로드: https://git-scm.com/downloads
필요한 운영체제 버전에 맞춰 설치 파일을 다운로드합니다. 이 소프트웨어들은 모두 오픈소스이며 무료입니다.
2. 설치 과정
2.1. Visual Studio Code 설치
설치 마법사를 따라 진행하며, 다음 사항에 유의합니다:
- 설치 경로 변경: 원하는 경로를 지정합니다 (예:
D:\VSCode). - 환경 변수(Path) 추가: VS Code를 시스템 Path에 추가하는 옵션을 선택하여 명령 프롬프트나 PowerShell에서
code명령으로 VS Code를 실행할 수 있도록 합니다.
설치 확인:
VS Code 설치 완료 후, 터미널(명령 프롬프트 또는 PowerShell)을 열어 다음 명령어를 입력합니다.
code --version
VS Code 버전 정보가 출력되면 Path 설정이 정상적으로 이루어진 것입니다.
VS Code 한글 언어 팩 설정:
VS Code를 실행하고 Extensions (확장) 탭에서 "Korean Language Pack"과 "C/C++" 확장을 검색하여 설치합니다. 설치 후 VS Code를 다시 시작하면 한글 환경이 적용됩니다.
2.2. Git 설치
설치 마법사 안내에 따라 진행하며, 몇 가지 권장 설정을 따릅니다:
- 설치 경로 선택: 원하는 경로를 지정합니다.
- 기본 편집기 선택: VS Code를 기본 Git 편집기로 설정할 수 있습니다.
- 기본 브랜치 이름: 초기 브랜치 이름을 “main”으로 설정하는 것을 권장합니다. 이는 “master”라는 용어의 역사적 배경으로 인한 잠재적 문제점을 피하기 위한 업계 표준 변경 사항입니다.
설치 확인:
Git 설치 완료 후, 모든 터미널 창을 닫고 새로 연 다음 다음 명령어를 입력합니다.
git --version
Git 버전 정보가 출력되면 설치가 성공적으로 완료된 것입니다.
MSVC (Microsoft Visual C++) 및 vcpkg 환경 구성
MSVC는 Microsoft에서 제공하는 C++ 개발 도구로, C, C++, C++/CLI 언어 편집을 지원하는 통합 개발 환경(IDE)을 포함합니다. vcpkg는 Microsoft와 C++ 커뮤니티가 관리하는 오픈소스 C/C++ 패키지 관리자로, Windows, Linux, macOS에서 라이브러리 설치 및 관리를 간소화합니다.
1. MSVC 설치
MSVC는 Visual Studio Installer를 통해 설치합니다.
- Visual Studio 다운로드: https://visualstudio.microsoft.com/ko/downloads/
Visual Studio Installer를 실행하고 “C++를 사용한 데스크톱 개발” 워크로드를 선택하여 설치합니다. 설치 경로는 기본값을 따르거나 원하는 위치로 변경할 수 있습니다 (예: D:\MSVC).
2. 환경 변수 설정
MSVC 컴파일러를 VS Code에서 사용하려면 시스템 환경 변수를 설정해야 합니다. “시스템 환경 변수 편집”을 검색하여 시스템 속성 창을 엽니다.
2.1. Path 변수 편집
시스템 변수 중 “Path”를 찾아 편집하고 다음 경로들을 추가합니다 ([MSVC 설치 경로]는 실제 설치 경로로 대체합니다).
[MSVC 설치 경로]\VC\Tools\MSVC\[버전]\bin\Hostx64\x64[MSVC 설치 경로]\Windows Kits\[버전]\bin\[세부 버전]\x64
2.2. LIB 및 INCLUDE 변수 추가
시스템 변수에 “LIB”와 “INCLUDE” 변수를 새로 추가하고 다음 경로들을 지정합니다.
LIB 변수:
[MSVC 설치 경로]\VC\Tools\MSVC\[버전]\lib\x64[MSVC 설치 경로]\Windows Kits\[버전]\Lib\[세부 버전]\ucrt\x64[MSVC 설치 경로]\Windows Kits\[버전]\Lib\[세부 버전]\um\x64
INCLUDE 변수:
[MSVC 설치 경로]\VC\Tools\MSVC\[버전]\include[MSVC 설치 경로]\Windows Kits\[버전]\Include\[세부 버전]\ucrt[MSVC 설치 경로]\Windows Kits\[버전]\Include\[세부 버전]\um[MSVC 설치 경로]\Windows Kits\[버전]\Include\[세부 버전]\winrt[MSVC 설치 경로]\Windows Kits\[버전]\Include\[세부 버전]\cppwinrt[MSVC 설치 경로]\Windows Kits\[버전]\Include\[세부 버전]\shared
3. MSVC 설치 확인
VS Code에서 새로운 C++ 파일을 생성하고 다음 코드를 작성합니다.
#include <iostream>
int main() {
std::cout << "Hello MSVC!" << std::endl;
return 0;
}
이 코드를 빌드하고 실행하려면 “Developer Command Prompt for VS”를 사용하는 것이 가장 편리합니다. 이를 실행한 후 VS Code를 열거나, VS Code 터미널에서 Ctrl+Shift+B를 눌러 cl.exe를 선택하여 빌드할 수 있습니다.
4. vcpkg 설치 및 설정
vcpkg는 Visual Studio와 함께 설치되며, 환경 변수만 추가하면 됩니다.
Path 환경 변수에 vcpkg 실행 파일이 있는 폴더 경로를 추가합니다 (예: D:\MSVC\VC\vcpkg).
설치 확인:
터미널에서 다음 명령어를 입력합니다.
vcpkg --version
vcpkg 버전이 출력되면 정상적으로 Path가 설정된 것입니다.
vcpkg 통합:
vcpkg를 시스템에 통합하기 위해 다음 명령어를 실행합니다.
vcpkg integrate install
이후 VS Code에서 vcpkg를 활용하는 방법에 대한 자세한 내용은 공식 vcpkg 문서를 참조할 수 있습니다.
MinGW (TDM-GCC) 및 MSYS2 환경 구성
TDM-GCC는 MinGW-w64 프로젝트의 최신 버전을 포함하는 Windows용 GCC 컴파일러 모음으로, C/C++ 프로그램 개발 및 디버깅에 유용합니다. MSYS2는 Windows에 Unix와 유사한 도구 체인과 패키지 관리 기능을 제공하여 네이티브 Windows 애플리케이션 개발을 돕는 환경입니다.
1. MinGW (TDM-GCC) 설치
- TDM-GCC 다운로드: https://tdm-gcc.tdragon.net/download
설치 마법사를 실행하여 Create 옵션을 선택하고, 원하는 버전을 선택한 후 설치 경로를 지정합니다 (예: D:\TDM-GCC). 모든 구성 요소를 다운로드하는 것을 권장합니다.
2. 환경 변수 설정
MinGW 컴파일러를 시스템 Path에 추가합니다. “시스템 환경 변수 편집”을 검색하여 시스템 속성 창을 엽니다.
시스템 변수 중 “Path”를 찾아 편집하고 다음 경로를 추가합니다 ([MinGW 설치 경로]는 실제 설치 경로로 대체합니다).
[MinGW 설치 경로]\bin
설치 확인:
새 터미널을 열고 다음 명령어를 입력합니다.
gcc --version
GCC 컴파일러 버전 정보가 출력되면 MinGW 설치 및 Path 설정이 완료된 것입니다.
3. MSYS2 설치
- MSYS2 다운로드: https://www.msys2.org/
설치 마법사를 따라 MSYS2를 설치합니다. 설치 경로는 원하는 위치로 지정합니다 (예: D:\msys64).
3.1. MSYS2와 MinGW 통합
MSYS2 터미널에서 외부 MinGW 컴파일러(예: TDM-GCC)를 사용하려면 ~/.bashrc 파일을 편집하여 Path를 설정합니다.
MSYS2가 설치된 경로 (예: D:\msys64)에서 mingw64.exe를 실행하여 MSYS2 MinGW 64-bit 터미널을 엽니다.
nano ~/.bashrc
파일 마지막에 다음 두 줄을 추가하고 저장합니다 ([TDM-GCC 설치 경로]는 실제 TDM-GCC 설치 경로로 대체합니다).
# TDM-GCC Path 설정 예시 (TDM-GCC가 C:\TDM-GCC-64에 설치되었다고 가정)
export TDM_GCC_PATH="/c/TDM-GCC-64/bin"
export PATH="$TDM_GCC_PATH:$PATH" # TDM-GCC 경로가 PATH의 가장 앞에 오도록 설정
파일을 저장한 후, MSYS2 터미널을 다시 시작하거나 source ~/.bashrc 명령을 실행하여 변경 사항을 적용합니다.
이제 MSYS2 터미널에서 gcc --version을 실행하면 통합된 MinGW 컴파일러 정보가 표시되어야 합니다.
Visual Studio Code JSON 설정 파일 이해
VS Code의 .vscode 폴더는 현재 작업 영역(프로젝트)에 특화된 설정 파일을 저장하는 곳입니다. 이 JSON 파일들은 편집기 동작, 빌드 작업, 디버깅 구성, 언어별 IntelliSense 등을 사용자 정의하여 프로젝트의 일관된 개발 환경을 유지하는 데 사용됩니다. 이 설정들은 전역 VS Code 설정에 영향을 주지 않고, 해당 작업 영역에만 적용됩니다.
1. settings.json: 작업 영역 설정 파일
역할: VS Code의 전역 설정을 덮어쓰고, 현재 프로젝트의 편집기 동작(예: 들여쓰기, 폰트), 언어별 기능(예: C++ 표준), 파일 연결 등을 사용자 정의합니다.
형식: JSON 키-값 쌍으로 구성됩니다.
주요 설정 항목 예시 (C/C++ 환경):
{
// 편집기 기본 설정
"editor.tabSize": 4, // 탭 크기 (스페이스 수)
"editor.insertSpaces": true, // 탭 대신 스페이스 사용
"editor.autoSave": "afterDelay", // 자동 저장 (afterDelay/onFocusChange/off)
"files.autoSaveDelay": 1000, // 자동 저장 지연 시간 (밀리초)
"files.exclude": { // 탐색기에서 숨길 파일/폴더
"**/.git": true,
"**/build": true // 빌드 출력 디렉토리 숨김
},
// C/C++ 언어 전용 설정 (C/C++ 확장 필요)
"C_Cpp.default.intelliSenseMode": "gcc-x64", // IntelliSense 모드 (gcc/clang/msvc)
"C_Cpp.default.cStandard": "c17", // 기본 C 표준
"C_Cpp.default.cppStandard": "c++17", // 기본 C++ 표준
// 통합 터미널 설정 (컴파일 및 실행 시 활용)
"terminal.integrated.defaultProfile.windows": "Command Prompt", // Windows 기본 터미널
"terminal.integrated.profiles.windows": { // 사용자 정의 터미널 프로필
"MSYS2 Bash": {
"path": "D:\\msys64\\usr\\bin\\bash.exe", // MSYS2 bash 실행 경로
"args": ["--login", "-i"] // MSYS2 로그인 셸 옵션
}
}
}
참고: 대부분의 설정은 VS Code UI (파일 > 기본 설정 > 설정 > 작업 영역)를 통해 변경하면 자동으로 이 파일에 반영됩니다.
2. tasks.json: 작업 구성 파일
역할: 컴파일, 패키징, 스크립트 실행 등 실행 가능한 작업을 정의합니다. VS Code의 “터미널 > 작업 실행” 메뉴를 통해 호출되거나, 디버그 설정(launch.json)에 연결되어 자동으로 실행될 수 있습니다 (예: 디버깅 전 컴파일).
형식: version (항상 “2.0.0”) 및 tasks 배열로 구성됩니다.
주요 설정 항목 예시 (C/C++ 컴파일 작업):
{
"version": "2.0.0",
"tasks": [
{
"label": "build_cpp_app", // 작업 이름 (고유해야 함)
"type": "shell", // 작업 유형: shell (터미널 명령 실행) / process (직접 프로그램 실행)
"command": "g++", // 컴파일 명령 (예: g++/cl.exe/msbuild)
"args": [ // 명령 인수 (순서대로 연결됨)
"-g", // 디버깅 정보 생성 (디버깅 필수)
"${workspaceFolder}/src/main.cpp", // 소스 파일 경로
"-o", // 출력 파일 지정 옵션
"${workspaceFolder}/build/my_app.exe", // 출력 실행 파일 경로
"-I${workspaceFolder}/include", // 헤더 파일 검색 경로
"-L${workspaceFolder}/lib", // 라이브러리 파일 검색 경로
"-lm" // 수학 라이브러리 연결 (예시)
],
"group": { // 작업 그룹 (분류용)
"kind": "build", // 'build' 그룹으로 분류
"isDefault": true // 이 그룹의 기본 작업으로 설정
},
"problemMatcher": ["$gcc"], // 문제 매처: GCC 컴파일러 오류/경고 인식 및 에디터에 표시
"detail": "C++ 프로그램 컴파일 (g++)", // 작업 상세 설명
"presentation": { // 터미널 표시 설정
"echo": true, // 명령 표시
"reveal": "always", // 컴파일 시 터미널 자동 표시
"focus": false, // 터미널에 자동 포커스하지 않음
"panel": "shared" // 모든 작업이 하나의 터미널 패널 공유
}
},
{
"label": "clean_build_artifacts", // 빌드 결과물 삭제 작업
"type": "shell",
"command": "rm",
"args": ["${workspaceFolder}/build/my_app.exe"],
"windows": { // Windows 시스템 전용 설정 (위의 command/args를 덮어씀)
"command": "del",
"args": ["${workspaceFolder}\\build\\my_app.exe"]
}
}
]
}
참고: ${workspaceFolder}는 프로젝트 루트 디렉토리(.vscode 폴더가 있는 곳)를 나타내는 VS Code 내장 변수입니다.
3. launch.json: 디버그 구성 파일
역할: 디버거 동작(프로그램 시작, 중단점 설정, 인자 전달 등)을 구성합니다. VS Code의 “실행 및 디버그” 패널과 함께 사용됩니다.
형식: version (항상 “0.2.0”) 및 configurations 배열로 구성됩니다.
주요 설정 항목 예시 (GDB로 C++ 프로그램 디버깅):
{
"version": "0.2.0",
"configurations": [
{
"name": "Launch C++ Application", // 디버그 구성 이름
"type": "cppdbg", // 디버그 타입: cppdbg (C/C++ 확장이 제공)
"request": "launch", // 디버그 방식: launch (프로그램 시작) / attach (실행 중인 프로그램에 연결)
"program": "${workspaceFolder}/build/my_app.exe", // 디버그할 프로그램 경로
"args": ["--config", "debug.ini"], // 프로그램에 전달할 명령줄 인수
"stopAtEntry": false, // 프로그램 진입점(main 함수)에서 자동 일시 정지 여부
"cwd": "${workspaceFolder}", // 프로그램 실행 작업 디렉토리
"environment": [ // 사용자 정의 환경 변수
{ "name": "PATH", "value": "${env:PATH};C:\\msys64\\mingw64\\bin" } // MinGW 도구 체인 경로 추가
],
"externalConsole": false, // 외부 콘솔 사용 여부 (true 시 Windows 콘솔 창 팝업)
"internalConsoleOptions": "openOnSessionStart", // 디버그 콘솔 열림 시점
// 디버거 설정 (GDB)
"MIMode": "gdb", // 디버거 모드: gdb (GNU Debugger) / lldb (LLVM Debugger)
"setupCommands": [ // 디버그 전 실행할 GDB 명령
{
"description": "gdb를 위한 pretty-printing 활성화",
"text": "-enable-pretty-printing",
"ignoreFailures": true
}
],
"preLaunchTask": "build_cpp_app", // 디버그 전 자동으로 실행할 작업 (tasks.json의 label과 일치)
"miDebuggerPath": "C:\\TDM-GCC-64\\bin\\gdb.exe", // GDB 실행 파일 경로 (사용자 설치 경로에 맞게 수정)
"logging": { // 디버그 로깅 설정
"moduleLoad": false,
"trace": true
}
}
]
}
참고: preLaunchTask는 tasks.json에 정의된 컴파일 작업을 연결하여 “디버그 전 자동 컴파일”을 가능하게 합니다.
4. c_cpp_properties.json: C/C++ 확장 설정 파일
역할: C/C++ 확장에 컴파일러 경로, 헤더 파일 경로, 매크로 정의 등의 정보를 제공하여 정확한 IntelliSense, 코드 탐색 및 구문 검사를 가능하게 합니다.
형식: configurations 배열 (Debug/Release 또는 다른 컴파일러 구성) 및 version (항상 4)으로 구성됩니다.
주요 설정 항목 예시 (TDM-GCC 또는 MSYS2 통합):
{
"configurations": [
{
"name": "MinGW-GCC", // 구성 이름 (C/C++ 확장 선택기에서 표시)
"includePath": [ // 헤더 파일 검색 경로
"${workspaceFolder}/**", // 프로젝트 내 모든 헤더 파일 재귀적으로 포함
"C:\\TDM-GCC-64\\include", // TDM-GCC 시스템 헤더 파일 경로
"C:\\msys64\\mingw64\\include" // MSYS2 MinGW 시스템 헤더 파일 경로 (필요에 따라 선택)
],
"defines": [ // 미리 정의된 매크로
"_DEBUG",
"UNICODE",
"_UNICODE"
],
"compilerPath": "C:\\TDM-GCC-64\\bin\\g++.exe", // 컴파일러 경로 (표준 라이브러리 및 구문 분석용)
"cStandard": "c17", // C 표준
"cppStandard": "c++17", // C++ 표준
"intelliSenseMode": "gcc-x64", // IntelliSense 모드 (컴파일러와 일치: gcc/clang/msvc)
"browse": { // 코드 탐색 설정 (정의로 이동 등)
"path": [
"${workspaceFolder}/**",
"C:\\TDM-GCC-64\\include"
],
"limitSymbolsToIncludedHeaders": true,
"databaseFilename": ""
}
}
],
"version": 4
}
참고: compilerPath는 IntelliSense가 표준 라이브러리 경로와 기본 매크로를 감지하는 핵심입니다. 경로가 잘못되면 IntelliSense가 제대로 작동하지 않을 수 있습니다.
5. extensions.json: 확장 추천 파일
역할: 현재 프로젝트에 권장되는 VS Code 확장을 지정합니다. 다른 개발자가 프로젝트를 열 때 VS Code가 이러한 확장을 설치하도록 제안하여 개발 환경의 일관성을 보장합니다.
형식: recommendations 배열로 구성됩니다.
주요 설정 항목 예시:
{
"recommendations": [
"ms-vscode.cpptools", // C/C++ 확장 (디버깅 및 IntelliSense 제공)
"EditorConfig.EditorConfig", // 코드 스타일 통일
"xaver.clang-format", // Clang-Format 기반 코드 포맷팅
"msys2.msys2" // MSYS2 통합 (MSYS2 환경 사용 시)
]
}
참고: 확장 ID는 VS Code 확장 마켓플레이스의 확장 상세 페이지에서 확인할 수 있습니다.
VS Code JSON 파일들의 협업 관계
C/C++ 프로젝트에서 이 JSON 파일들은 다음과 같이 상호작용하며 개발 프로세스를 지원합니다:
c_cpp_properties.json: 컴파일러 및 헤더 경로 정보를 제공하여 IntelliSense가 정확하게 작동하도록 합니다.tasks.json: 빌드 작업을 정의하여 실행 파일 등을 생성합니다.launch.json: 빌드 작업을 연결하고 디버깅 매개변수를 구성하여 “한 번의 클릭으로 컴파일 + 디버그”가 가능하도록 합니다.settings.json: 들여쓰기, 터미널 유형 등 편집기 전반의 동작을 조정합니다.extensions.json: 팀원 간 필수 도구를 통일하여 환경 일관성을 유지합니다.
모든 프로젝트에서 이 모든 파일이 필수로 요구되는 것은 아니며, 프로젝트의 규모와 요구사항에 따라 유연하게 구성할 수 있습니다. 이러한 JSON 설정을 통해 다양한 컴파일러(MSVC, MinGW), 빌드 도구(Make, CMake), 디버깅 시나리오에 맞춰 개발 환경을 최적화할 수 있습니다.