[게임 개발 독학기] #3. 파이썬 개발 환경 구축하기: Python 및 VS Code 설치부터 환경 변수 설정까지 완벽 가이드

예니토토

 지난 포스팅에서는 게임 개발자로서 왜 파이썬을 배워야 하는지, 그리고 앞으로의 AI 게임 개발자 로드맵에 대해 이야기 나누었습니다. 방향성을 정했다면 이제 직접 코드를 치고 실행해 볼 수 있는 '작업실'을 차릴 차례입니다.

프로그래밍을 처음 시작할 때 의외로 많은 분이 코드 문법이 아니라 '개발 환경 세팅' 단계에서 막혀 포기하곤 합니다. 검은 화면에 에러 메시지가 뜨면 당황하기 쉽기 때문인데요. 오늘은 초보자도 에러 없이 한 번에 끝낼 수 있도록, 파이썬과 전 세계 개발자들이 가장 사랑하는 코드 편집기인 'VS Code(Visual Studio Code)' 설치 및 연동 방법을 단계별로 아주 쉽게 정리해 보겠습니다.


1단계: 파이썬(Python) 설치 시 '이것' 반드시 체크하기!

먼저 컴퓨터의 뇌 역할을 해줄 파이썬 번역기를 설치해야 합니다.

  1. 공식 홈페이지 접속: 구글에 'Python'을 검색하거나 파이썬 공식 웹사이트(python.org)에 접속합니다.

  2. 다운로드 진행: Downloads 메뉴에서 본인의 운영체제(Windows/Mac)에 맞는 최신 버전을 다운로드합니다. (게임 개발 및 AI 라이브러리 호환성을 위해 너무 최신 버전보다는 안정화된 버전을 추천하지만, 독학 초기에는 기본 최신 버전을 받으셔도 무방합니다.)

  3. ★가장 중요한 체크포인트 (Add python.exe to PATH): 설치 창이 뜨면 맨 아래에 있는 Add python.exe to PATH (또는 Add Python to environment variables) 체크박스에 반드시 체크를 하셔야 합니다!

    • 이유는 무엇인가요? 이 체크를 누르지 않으면 컴퓨터가 파이썬이 어디에 설치되어 있는지 찾지 못해, 나중에 명령 프롬프트(CMD)에서 파이썬을 실행할 때 "알 수 없는 명령어"라는 에러를 뿜어내게 됩니다. 환경 변수를 자동으로 잡아주는 옵션이니 꼭 체크하고 Install Now를 눌러주세요.

2단계: 개발자의 필수품, VS Code 설치하기

메모장에 코딩을 할 수는 없으니, 오타를 잡아주고 자동 완성 기능을 제공하는 똑똑한 코드 편집기(IDE)가 필요합니다. 우리는 마이크로소프트에서 만든 무료 편집기인 VS Code를 사용할 것입니다.

  1. 공식 홈페이지 접속: code.visualstudio.com에 접속하여 본인의 OS용 설치 파일을 다운로드합니다.

  2. 설치 진행: 설치 과정에서 나오는 기본 옵션들은 모두 '다음'을 눌러 진행하시면 됩니다. 바탕화면 바로가기 만들기를 체크해 두면 편리합니다.

3단계: VS Code 내에서 파이썬 확장 프로그램 설치 및 연동

VS Code는 그 자체로는 깔끔한 메모장과 같습니다. 여기에 파이썬을 편리하게 쓸 수 있도록 전용 플러그인을 장착해 주어야 합니다.

  1. 확장 디렉토리 열기: VS Code를 실행한 뒤, 왼쪽 메뉴 바 맨 아래에 있는 네모 모양 아이콘(Extensions, 단축키: Ctrl + Shift + X)을 클릭합니다.

  2. Python 검색 및 설치: 검색창에 'Python'을 입력하고, Microsoft에서 공식 제작한 가장 상단의 확장 프로그램을 찾아 Install 버튼을 누릅니다. 이 프로그램이 설치되어야 코드 색상이 예쁘게 구별되고 자동 완성 기능이 작동합니다.

4단계: 첫 번째 파이썬 코드 실행 및 트러블슈팅

모든 세팅이 끝났으니 제대로 작동하는지 테스트해 볼 시간입니다.

  1. 파일 생성: VS Code 상단 메뉴에서 File -> New File을 누르고, 파일 이름을 test.py로 저장합니다. (파이썬 파일은 반드시 확장자가 .py로 끝나야 합니다.)

  2. 코드 작성: 열린 메모장에 지난번에 배웠던 기본 출력 코드를 적어봅니다.

    Python
    print("AI 게임 개발자 전용 작업실 구축 완료!")
    
  3. 코드 실행: 우측 상단에 있는 재생 버튼(▷, Run Python File)을 클릭합니다.

  4. 결과 확인: 하단 터미널(Terminal) 창에 우리가 적은 "AI 게임 개발자 전용 작업실 구축 완료!"라는 문구가 정상적으로 출력된다면 완벽하게 성공한 것입니다!

  • 💡 만약 에러가 난다면? 터미널에 'Python이라는 명령어를 찾을 수 없습니다'라는 메시지가 뜬다면 십중팔구 1단계에서 말씀드린 Add PATH 체크를 누락하신 것입니다. 당황하지 마시고 파이썬 설치 프로그램을 다시 켜서 Modify를 누르거나, 재설치를 진행하며 체크박스를 꼭 체크해 주세요!

5. 환경 세팅을 마치며

드디어 나만의 AI 게임 개발을 위한 첫 번째 인프라가 구축되었습니다. 이제 이 공간에서 파이썬의 기초 문법을 익히고, 데이터를 분석하고, 나아가 게임 엔진과 연동하는 일만 남았습니다. 컴퓨터와 친해지는 첫 단계인 만큼 서두르지 말고 하나씩 손으로 만져보며 익히는 재미를 느끼셨으면 좋겠습니다.

다음 포스팅부터는 파이썬에서 가장 중요한 데이터를 다루는 법인 '변수와 자료형'에 대해 본격적으로 코드를 짜며 알아보겠습니다. 즐거운 코딩 학습 되세요!



댓글 쓰기