게임 프로그래밍을 시작하면 가장 먼저 만나는 벽이 개발 환경 설정입니다. 설치할 항목이 많고, 엔진과 연결이 안 되거나 빌드 오류가 나면 코드 한 줄 쓰기 전에 지치기 쉽습니다. 윈도우에서 비주얼 스튜디오로 C++과 유니티·언리얼 개발 환경을 갖추는 기본 순서를 정리합니다.

비주얼 스튜디오와 VS Code는 다르다

이름이 비슷해 헷갈리지만 둘은 다른 프로그램입니다. 비주얼 스튜디오(Visual Studio)는 컴파일러, 디버거, 프로젝트 관리 기능이 모두 들어 있는 통합 개발 환경(IDE)이고, VS Code는 가벼운 코드 편집기에 확장 기능을 더해 쓰는 방식입니다. C++ 게임 개발이나 언리얼 엔진 작업에는 비주얼 스튜디오가 일반적으로 쓰이고, 개인 학습용으로는 무료로 제공되는 커뮤니티 에디션을 많이 씁니다. 라이선스 조건은 공식 안내에서 확인하세요.

설치할 때 고르는 워크로드

비주얼 스튜디오 설치 프로그램은 필요한 기능 묶음을 '워크로드'로 고르게 되어 있습니다. 목적에 맞는 것만 골라야 설치 용량과 시간을 줄일 수 있습니다. 워크로드 이름은 버전에 따라 조금씩 다를 수 있습니다.

언리얼 엔진은 엔진 버전마다 권장하는 비주얼 스튜디오 버전과 구성 요소가 정해져 있습니다. 설치 전에 사용할 엔진 버전의 공식 문서를 반드시 확인하세요. 버전이 맞지 않으면 프로젝트가 빌드되지 않는 문제가 생길 수 있습니다.

엔진과 연결하기

1. 유니티: 에디터의 환경 설정(Preferences) > External Tools에서 외부 스크립트 편집기를 비주얼 스튜디오로 지정합니다. 그러면 스크립트를 더블클릭할 때 비주얼 스튜디오가 열리고 자동 완성이 동작합니다.
2. 유니티 패키지 관리자에서 Visual Studio Editor 패키지가 설치되어 있는지 확인합니다. 자동 완성이 안 될 때 가장 먼저 볼 부분입니다.
3. 언리얼: C++ 프로젝트를 만들면 솔루션 파일(.sln)이 생성됩니다. 이 파일을 비주얼 스튜디오로 열고, 솔루션 구성을 개발용 에디터 빌드로 맞춘 뒤 빌드합니다.
4. 언리얼 프로젝트 파일이 꼬였을 때는 .uproject 파일 메뉴에서 프로젝트 파일 다시 생성을 실행하면 해결되는 경우가 많습니다.

디버깅 기본기 익히기

개발 환경을 갖췄다면 디버거 사용법부터 익히는 것이 좋습니다. 로그를 찍어 보는 것만으로는 원인을 찾기 어려운 버그가 많습니다.

• 중단점(Breakpoint): 코드 줄 왼쪽을 클릭하면 실행이 그 줄에서 멈춥니다. F9로 설정합니다.
• 단계 실행: F10은 한 줄씩 넘어가고, F11은 함수 안으로 들어갑니다.
• 조사식·지역 변수 창: 멈춘 시점의 변수 값을 확인합니다. 예상과 다른 값이 버그의 단서입니다.
• 유니티 연결: 비주얼 스튜디오에서 Unity에 연결(Attach to Unity)을 실행한 뒤 에디터에서 플레이하면 스크립트 중단점에서 멈춥니다.

중단점을 걸고 변수 값을 따라가는 습관은 실력 차이를 크게 만듭니다. 막연히 코드를 고쳐 보는 대신 문제가 생긴 지점을 정확히 찾아낼 수 있기 때문입니다.

자주 겪는 문제와 해결

• 자동 완성이 안 된다: 엔진의 외부 편집기 설정과 관련 패키지를 확인하고, 프로젝트 파일을 다시 생성합니다.
• 빌드할 때 SDK를 찾지 못한다: 설치 프로그램에서 해당 워크로드의 Windows SDK 구성 요소가 설치되었는지 확인합니다.
• 한글 경로 문제: 사용자 이름이나 프로젝트 경로에 한글·공백이 있으면 일부 도구에서 오류가 날 수 있으니 영문 경로를 권합니다.
• 저장 공간 부족: 엔진과 개발 도구, 중간 빌드 파일이 큰 용량을 차지하므로 넉넉한 SSD에 설치합니다.

SBS아카데미게임학원 게임프로그래밍 과정은 C언어·C++ 기초와 WinAPI 실습에서 시작해 유니티·언리얼 엔진 기반 프로젝트로 이어지므로, 이 글에서 설명한 개발 환경을 실제 수업 흐름 속에서 갖춰 볼 수 있습니다.

자주 묻는 질문