이클립스(Eclipse)에 파이썬(Python) 설치 및 PyDev 완벽 연동 가이드

 

보통 파이썬(Python) 언어를 구사하고 배우기 시작할 때는 PyCharm(파이참)이나 VS Code(비주얼 스튜디오 코드)라는 개발 도구를 가장 많이 사용하는 편입니다. 실제로 개발자 커뮤니티나 강의를 보면 대부분이 이러한 툴을 추천하곤 합니다. 하지만 저를 포함하여 기존에 자바(Java)나 웹 개발을 주로 하셨던 분들이라면 이미 이클립스 환경에 손과 눈이 완전히 익숙해져 있을 것입니다. 새로운 단축키와 UI를 익히는 것도 생각보다 큰 리소스가 소비되는 일이기 때문입니다.

 

이클립스에 익숙한 분들이라면 굳이 낯선 파이참으로 넘어가기보다는, 기존의 강력한 이클립스 환경에 파이썬 플러그인을 얹어서 사용하는 것도 작업 효율성 면에서 굉장히 좋은 선택입니다. 하나의 IDE 안에서 자바 백엔드와 파이썬 데이터 분석, 혹은 웹 크롤링 스크립트를 동시에 관리할 수 있다는 것은 실무에서 엄청난 메리트가 됩니다. 직접 이클립스에 파이썬 개발 환경을 구축해 보니, 익숙함에서 오는 안정감 덕분에 코드 생산성이 훨씬 높아지는 것을 경험할 수 있었습니다.

 

그래서 오늘은 파이썬 환경 구축을 고민하는 개발자분들을 위해, 이클립스에서 마켓플레이스를 통해 PyDev를 설치하고 명령 프롬프트를 오가며 필수 라이브러리까지 완벽하게 세팅하는 과정을 공유하고자 합니다.

 

 

 

 

 

사전 준비: 파이썬 PC 설치 및 환경 변수 확인

 

이클립스에서 파이썬을 구동하기 위해서는 파이썬이 먼저 설치되어 있어야 합니다. 만약 설치가 안 되어 있다면 파이썬 공식 홈페이지에서 최신 안정화 버전을 다운로드합니다.

 

 

PC 내, 파이썬 설치가 되어 있다면 파이썬 버전이 출력됩니다.

 

⚠️ 이 설정은 꼭! 기억하세요!

파이썬 설치 시 가장 많이 발생하는 오류가 바로 '환경 변수(PATH) 추가' 누락입니다. 설치 파일 첫 화면 하단의 'Add python.exe to PATH' 체크박스를 반드시 체크해야 나중에 명령 프롬프트나 이클립스에서 파이썬 라이브러리를 정상적으로 인식합니다. 데이터 분석 및 웹 크롤링 고성능 라이브러리를 다룰 때 이 설정이 꼬이면 실행 오류가 발생할 수 있으니 꼭 체크합니다.

 

 

 

 

 

이클립스 설치하기

 

1.  브라우저에 이클립스를 검색 후, 해당 홈페이지로 이동합니다.

 

 

이클립스 공식 홈페이지

Eclipse Downloads | The Eclipse Foundation

 

 

 

 

 

2.  'Download Packages'를 클릭합니다.

 

 

 

 

 

 

3.  'Eclipse IDE for Enterprise...' 항목의 Download 'x86_64'로 클릭합니다.

 

 

 

 

 

 

4.  File 옆 '.zip' 파일을 다운로드합니다.

 

 

 

 

 

 

인코딩 설정 및 파이썬 플러그인 설치

 

인코딩 설정

 

1.  설치한 이클립스를 실행 후, 원하는 워크스페이스 경로를 선택하고 실행합니다.

 

 

 

 

 

 

2.  이클립스가 실행됩니다.

 

 

 

 

 

 

3.  스폰서 정보를 종료하면 익숙하게 보던 이클립스 본 화면이 나타납니다.

 

 

 

 

 

 

4.  인코딩 설정을 위해 Window > Preferences 메뉴를 클릭합니다.

 

 

 

 

 

 

5.  'enc'를 검색 후, 나타나는 모든 항목들의 'UTF-8'로 인코딩 설정합니다. 가장 먼저 General > Content Types의 'Gradle Build Script', 'Image', 'JaCoCo Execution Data File'... 차례대로 모든 항목의 인코딩을 'UTF-8'로 설정합니다.

 

 

 

 

 

 

6.  General > Workspace에서는 하단의 Text file encoding 부분을 'UTF-8'로 설정합니다.

 

 

 

 

 

 

7.  Web > CSS Files에서 Encoding 항목을 UTF-8로 설정합니다.

 

 

 

 

 

 

8.  Web > HTML Files에서 Encoding 항목을 UTF-8로 설정합니다.

 

 

 

 

 

 

9.  Web > JSP Files에서 Encoding 항목을 UTF-8로 설정합니다.

 

 

 

 

 

 

10.  XML > XML Files에서 Encoding 항목을 UTF-8로 설정합니다.

 

 

 

 

 

 

파이썬 플러그인 설치

 

11.  Help > Eclipse Marketplace 메뉴를 클릭합니다.

 

 

 

 

 

 

12.  'pydev'를 검색 후, 'PyDev - Python IDE for Eclipse 13.1.0'을 Install 합니다.

 

 

 

 

 

 

13.  라이선스 동의를 체크 후, 진행합니다.

 

 

 

 

 

 

14.  설치 중 나타나는 'Trust Authorities' 윈도우에서 'Select All' 버튼을 눌러 모든 항목을 선택 후 'Trust' 버튼을 클릭하여 설치를 진행합니다.

 

 

'Trust' 버튼을 클릭해 설치를 진행하다 보면 설치가 완료되고 재시작하라는 윈도우 버튼이 나타납니다. 이클립스를 재시작합니다.

 

 

 

 

15.  재시작 후, 'Perspective'를 'PyDev'로 선택합니다.

 

 

 

 

 

 

파이썬 설치 및 설정

 

16.  퍼스펙티브 파이썬을 선택합니다.

 

 

 

 

 

 

17.  명령 프롬프트를 열고, 파이썬 가상환경을 만들기 위해서 아래 명령어를 차례대로 실행합니다.

 

 

⌨️ 실행 명령어

cd /
mkdir venvs
cd venvs
python -m venv basic

 

---

📢 가상환경 설정 시, 'python -m venv basic' 명령어가 작동하지 않을 때

정상적인 경우라면 해당 명령어 다음 줄에 아무 글자도 없이 넘어가야 하지만, Python이라는 글자가 출력된다면, 파이썬 환경 자체에 꼬임이 발생했을 가능성이 매우 높습니다.

보통 파이참이 설치되어 있는 상태라면 위와 같은 문제가 발생할 수 있습니다. 파이참을 설치하면 파이참 내부에서만 사용할 파이썬 실행 경로를 사용하므로 환경 변수에 의한 파이썬 환경이 제대로 설정되지 않을 수 있습니다.

이런 경우엔, 파이썬을 별도로 설치 후, 가상환경을 다시 설정해야 합니다.

 

파이썬 설치하기

 

1.  파이썬 공식 홈페이지에 접속합니다.

 

 

파이썬 공식 홈페이지

Welcome to Python.org

 

 

 

 

 

2.  파이썬 다운로드 페이지로 이동 후, 사용 중인 OS 버전에 맞춰 설치 파일을 다운로드합니다.

 

 

 

 

 

 

3.  파이썬 설치 윈도우에서 'Add python.exe to PATH' 체크박스에 꼭 체크 후, Install Now를 클릭합니다.

 

 

 

 

 

 

4.  설치를 진행합니다.

 

 

 

 

 

 

5.  설치가 완료되었고, 하단에 'Disable path length limit'을 눌러 PATH 길이 제한 설정을 해제합니다.

 

 

🎯 중요!

해당 경고처럼 보이는 메시지는 "윈도우가 가진 오래된 제약을 해제하겠습니까?"라고 물어보는 옵션입니다. 해당 옵션은 클릭 후 해제합니다. 'Disable path length limi' 옵션 설정은 윈도우 시스템에서 아주 오래전부터 파일이나 폴더의 전체 경로 길이를 최대 260글자까지만 인식할 수 있도록 제한되어 있는데 이걸 해제하겠다는 옵션입니다.

파이썬으로 개발을 하다 보면, 다양한 라이브러리를 설치하는 과정에서 폴더 안에 폴더가 끊임없이 깊어지면서 경로가 260 글자를 훌쩍 넘겨버리는 일이 자주 발생할 수 있습니다. 이 제한에 걸리면 파이썬이 라이브러리를 제대로 설치하지 못하거나 에러를 뿜게 됩니다. 

 

 

 

 

 

6.  Close 버튼을 눌러 설치를 마무리합니다.

 

 

---

 

 

 

 

 

17번에서 막혔던, 'venv' 명령어를 진행하는 과정에서 파이썬 설치가 누락되어 문제가 되었습니다. 파이썬 설치가 마무리되었으니 이어서 진행하도록 하겠습니다.

 

18.  아래 명령어를 다시 실행합니다.

 

 

⌨️ 실행 명령어

cd /venvs
python -m venv basic

 

 

 

 

 

19.  C드라이브에 만들어진 'venvs' 폴더를 확인해 보면 가상환경으로 설정될 'basic' 폴더가 생성되어 있는 걸 확인할 수 있습니다.

 

 

 

 

 

 

20.  가상환경을 실행하기 위해서, 아래 명령어를 실행합니다.

 

 

⌨️ 실행 명령어

./basic/Scripts/activate.bat

 

해당 명령어는 basic이라는 가상환경을 활성화하기 위해서입니다. 가상환경 폴더를 만드는 것만으로는 가상환경이 작동하지 않습니다. 해당 명령어를 실행해야 비로소 '지금부터 실행하는 파이썬 코드나 라이브러리 설치는 컴퓨터 전체 공간이 아니라, basic 이라는 공간에서 처리하는구나.'라고 인지합니다. 

 

 

 

 

 

21.  가상환경 실행에 문제가 없다면, 'deactivate' 명령어로 가상환경을 끕니다.

 

 

'deactive' 명령어는 사용 중이던 가상환경을 끄고, 컴퓨터 원래의 기본 상태로 돌아오기(비활성화) 위한 명령어입니다. 명령어 앞에 있는 (basic)은 현재 basic 가상환경이 켜져 있다는 뜻입니다. 가상환경에서 필요한 라이브러리를 설치하고 싶을 때 가상환경을 실행 후, 설치가 완료되면 비활성화로 종료할 수 있습니다. 가상환경을 각각 실행 후 종료하는 해당 과정을 하는 이유는 컴퓨터 한 곳에만 모든 파이썬 라이브러리를 설치하게 되면 각 프로젝트에서 라이브러리를 달리 사용할 수 없습니다. 그렇기 때문에, basic이라는 독립된 가상환경을 만들어두고 activate로 들어가 필요한 버전을 설치하고 다른 프로그램이나 프로젝트에 전혀 영향을 주지 않고 완벽하게 독립된 청정 구역에서 안전하게 개발할 수 있습니다. 

 

 

 

 

 

22.  이클립스가 파이썬을 실행하기 위한 인터프리터 설정을 위해서, Window > Preferences 메뉴의 PyDev > Interpreters > Python Interpreter 메뉴로 들어갑니다.

 

 

이클립스는 파이썬을 실행할 능력이 없습니다. 그렇기 때문에 파이썬 코드를 컴퓨터가 이해할 수 있는 기계어로 바꿔서 실행해 주는 '인터프리터' 프로그램을 설정하게 됩니다.

 

 

 

 

 

23.  Python Interpreters 항목의 오른쪽 New > Browse for python/pypy exe를 클릭합니다.

 

 

 

 

 

 

24.  가상환경으로 만들었던 'C:/venvs/basic/Scripts' 폴더 내, python.exe 파일을 선택합니다.

 

 

 

 

 

 

25.  인터프리터 이름을 'basic'으로 설정 후, OK 버튼을 클릭합니다. 

 

 

인터프리터명은 꼭 'basic'으로 하지 않아도 됩니다. 원하는 이름이 있다면 이름을 달리 설정합니다.

 

 

 

 

 

26.  설치가 질행 될 패키지 목록이 나타나고, OK 버튼을 클릭합니다.

 

 

🎯 setuptools가 보이지 않을 때

파이선 정책의 변화로 옛날 파이썬 버전에서는 가상환경을 만들면 pip와 setuptools가 항상 세트로 설치되었습니다. 하지만, 파이선 개발 진영에서 pip만 있어도 웬만한 패키지 설치와 관리가 다 되는데, 굳이 사용하지 않는 사람들에게까지 setuptools를 강제로 무겁게 깔아줄 필요가 없다고 판단하여 기본 가상환경 생성 목록에서 제외되는 경우가 있습니다. 설치하는 파이썬 버전(Python 3.12 이상)에 따라 최신 표준 정책에 맞춰 pip 하나만 들어오게 됩니다.

 

 

 

 

 

27.  명령 프롬프트를 열고 가상환경을 실행 후, 'pip install pytube3' 명령어를 실행하여 pytube3을 설치합니다.

 

 

⌨️ 실행 명령어

pip install pytube3

 

 

 

 

 

28.  pytube를 설치했다 하더라도, 패키지 영역에 들어오지 않습니다. 새로고침을 위해서, 'Manage with pip' 버튼을 클릭합니다.

 

 

 

 

 

 

29.  보이는 창에서는 따로 설정할 것이 없습니다. Close 버튼을 눌러 취소합니다.

 

 

 

 

 

 

30.  28번에서 보이지 않았던, 패키지 목록이 새로고침되어 있는 걸 확인할 수 있습니다. Apply와 Apply and Close를 눌러 적용합니다.

 

 

 

 

 

 

파이썬 프로젝트 생성하기

 

31.  File > New > PyDev Project를 클릭합니다.

 

 

 

 

 

 

32.  프로젝트명, 타입, Version 등을 설정 후 Finish 버튼을 클릭합니다.

 

 

 

 

 

 

33.  설정한 프로젝트명으로 프로젝트가 생성됩니다.

 

 

 

 

 

 

34.  패키지를 설정하기 위해서 PyDev Package를 선택하고 패키지명을 입력 후, Finish 버튼을 클릭합니다.

 

 

 

 

 

 

35.  패키지를 설정하고, 아래와 같은 윈도우 설정이 나타납니다. OK 버튼을 클릭합니다.

 

 

해당 윈도우는 파이썬 실행 속도를 더 빠르게 하기 위해 이클립스의 몇 가지 기본 설정을 자동으로 최적화하기 위한 설정입니다. 이클립스는 원래 자바나 C++ 같은 언어를 위해 만들어진 프로그램입니다. 해당 언어들은 코드를 실행하기 전에 반드시 빌드라는 무겁고 오래 걸리는 준비 과정을 거쳐야 합니다. 하지만, 파이썬은 빌드 과정이 필요 없는 인터프리터 언어입니다. 

 

Wait for ongoing build before launching : never
- 코드를 실행할 때 백그라운드에서 돌고 있는 다른 빌드 작업을 기다리지 않고 파이선을 즉시 실행합니다.

Build before launching : no
- 파이썬 파일을 실행하기 전에 이클립스가 불필요하게 빌드 과정을 시작하는 것을 방지합니다.

Re-check whenever a PyDev editor is opened?
- 이 최적화 세팅이 풀렸는지 파이선 에디터를 열 때마다 자동으로 체크합니다.

 

 

 

 

 

36.  '__init__.py'가 자동 생성되고, 'Hello World'를 입력하고 출력해 봅니다. 해당 파일을 선택 후, 마우스 우클릭으로 Run As를 진행합니다.

 

 

 

 

 

 

37.  Console 창에 출력하기 위해 작성한 'Hello World!'가 출력되는 걸 확인할 수 있습니다.

 

 

 

 

 

 

PyDev Module 패키지 설정

 

38.  File > New 메뉴의 'PyDev Module'을 선택합니다.

 

 

 

 

 

 

39.  Python Module명을 입력 후, Finish 버튼을 클릭합니다.

 

 

 

 

 

 

40.  템플릿 설정을 위해서 여러 종류들 중, '<Empty>'를 선택합니다. 하지만, Empty 패키지 내 사용하지 않는 내용을 삭제 후 사용하기 위해서 아래 'Config available templates...'를 클릭합니다.

 

 

 

 

 

 

41.  '<Empty>' 템플릿을 선택 후, Edit 버튼을 클릭합니다.

 

 

 

 

 

 

42.  Pattern 내용을 '${cursor}'로 변경 후, OK 버튼을 클릭합니다.

 

 

 

 

 

 

43.  최종 Apply와 Apply and Close 버튼을 클릭해, 해당 패키지 설정을 적용합니다.

 

 

 

 

 

 

@Junesker

---