파이썬 이클립스 프로젝트 생성하고 HelloWorld 완성하기

반갑습니다, 개발 동료 여러분! 오늘은 우리가 매일 사용하고 배우게 되는 파이썬 개발 환경인 이클립스 (Eclipse) 를 활용하는 실제 작업을 본격적으로 시작해보려 합니다. 지난번 포스팅에서는 기본적인 IDE 설정과 퍼스펙티브 (Perspective) 뷰 구성에 대해 살펴봤는데, 많은 분께 도움이 되셨기를 바랍니다. 오늘부터는 진짜 코딩을 위해 프로젝트를 생성하고 실행해보는 과정까지 완벽하게 다뤄볼게요.

왜 프로젝트 개념이 필요한 걸까요? 단순히 파일들을 한 폴더에 넣는 것과는 다릅니다. 개발 도구 내에서 설정하는 버전 정보나 디펜던시, 인터프리터 연결 상태 등을 함께 관리할 수 있는 단위이기 때문이죠. 이클립스에서는 이를 PyDev Project라고 부릅니다. 이제부터 화면을 따라하며 단계를 설명해드릴 테니 집중해서 따라해 보세요.

먼저 상단 메뉴바에서 [File]를 선택하신 뒤, 하위 옵션인 [New]를 클릭합니다. 그리고 팝업 창이 뜨면 다른 (Other) 메뉴로 이동하죠. 여기서 우리는 PyDev 카테고리를 찾아서 PyDev Project 항목을 선택하고 Next 버튼을 눌러줍니다. 프로젝트 이름은 개발자나 팀 이름을 포함해서 지명하는 것이 좋으며, 버전 정보는 현재 설치된 파이썬버전과 일치해야 원활한 컴파일과 실행이 가능합니다.

하지만 여기서 많은 초보 개발자들이 겪는 문제를 마주하게 됩니다. 바로 인터프리터 연결이 안 된다는 경고 메시지죠. 화면 상단에 빨간색으로 Project Interpreter not specified 이라는 텍스트가 뜨면 당황할 수 있지만, 이는 아주 흔한 상황입니다. 우리가 설치한 파이썬 위치를 이클립스에서 인지하지 못했기 때문이에요.

이러한 에러 메시지를 해결하기 위해서는 환경 설정을 직접적으로 수정해야 합니다. [Windows] 메뉴에서 [Preferences] 옵션으로 가는 것이 중요합니다. 이곳을 클릭하면 설정 창이 열리니 왼쪽 트리뷰에서 PyDev를 선택해 줍니다. 다음 하위 메뉴인 Interpreters > Python Interpreter 항목을 클릭하시면 실제 인터프리터 설정 화면에 도착합니다.

여기서 우리는 python.exe 파일의 경로를 직접 지정할 수도 있지만, 더 편리한 방법이 있습니다. 바로 우측 모서리에 있는 Quick Auto-Config 버튼입니다. 이 버튼을 누르면 시스템에 설치된 파이썬 폴더를 자동으로 감지하고 연결해 줍니다. 검색이 완료되면 경고 메시지가 사라지고 버전 설정이 제대로 완료되었음을 알 수 있죠. 이때 프로젝트 경로를 지정한 뒤 저장 (Save as 또는 OK) 을 눌러 프로젝트를 생성합니다.

프로젝트가 생성되었다면 이제 소스 코드를 작성할 파일도 만들어야 합니다. src 폴더 안에 우측 마우스를 누르고 [New] > [PyDev Module] 메뉴를 선택하면 됩니다. 여기서 파일 이름을 입력하는 것은 매우 신중해야 하는 부분입니다. 파이썬은 대소문자를 구별하고 언더바 (_) 를 사용하는 스네이크 케이스 표기법을 권장하므로, 숫자로 시작하지 않는 알파벳 소문자로 이름을 짓는 것이 중요합니다.

예를 들어 send_file_message.py와 같이 지명하는 것이 좋으며, 한 번에 파일명을 만들 때 너무 길고 복잡한 이름은 가독성을 떨어뜨릴 수 있으니 주의해야 합니다. 이제 준비된 파일에는 가장 유명한 첫 번째 프로그램을 만들어볼 거예요. 바로 print 함수를 이용해 ‘hello’라는 문자열을 콘솔 화면에 출력해 봅니다. 이는 우리가 만든 프로그램이 정상적으로 컴파일되고 실행되는지 확인하는 검증 수단이에요.

실행을 위해서는 Run > Run/Debug 메뉴를 선택하거나 단축키인 Ctrl+F11 을 누르면 됩니다. F11 키만으로도 동일하게 동작하지만, 단축키는 기억해두시면 작업 속도가 빨라집니다. 결과적으로 아래 콘솔 창에 ‘hello’라는 텍스트가 정확히 찍혀나가면恭喜你예요! 이상한 에러 없이 프로그램이 실행되었음을 의미하죠.

지금까지의 과정을 통해 이클립스 IDE 나 프로젝트 설정뿐만 아니라 소스 코드 작성 규칙까지 자연스럽게 익혔습니다. 단순히 툴을 설치하는 것을 넘어, 개발자가 실제로 코드를 작성하고 관리하는 방식을 이해하는 것이 가장 중요합니다. 이후에는 실제 데이터를 다루거나 웹 크롤링 등의 기능을 구현해 보며 지식을 확장해 나가시길 바랍니다. 다음 편에서는 더 심화 내용을 준비 중이므로 기대해 주세요.

개발 환경은 단순히 설치만 끝나는 것이 아니라, 매일 사용하면서 최적화해야 합니다. 위와 같이 기본 설정을 잘 다지기만 해도 버그를 줄이고 에러 해결 시간을 크게 단축할 수 있습니다. 오늘 소개된 과정들을 직접 따라잡는 데에는 10 분 정도면 충분하니 지금 바로 적용해 보세요. 모든 설정이 끝났으니 마음 편하게 다음 프로젝트로 넘어가실 수 있을 것입니다.

이 글은 녹두장군 – 상상을 현실로의 기사를 바탕으로 작성되었습니다.